Finance : Prepaid deposits

Omschrijving

Waardeer het prepaid-saldo van het account op. De call maakt een storting (deposit) aan en levert een checkout_url terug: de betaalpagina waarnaar je de betaler doorstuurt om de betaling af te ronden. Zodra de betaling is voltooid, wordt het gestorte bedrag aan het prepaid-saldo toegevoegd.

Endpoint

Body-parameters

Het verzoek verwacht een JSON-body met de volgende velden:

Antwoord

Voorbeeld

Beschrijving:
Stort € 5,00 op het prepaid-saldo via iDEAL en toon de checkout_url. Omdat iDEAL betaalkosten kent, bevat het antwoord een surcharge.

• PHP
• cURL

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/finance/deposits";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$a_data    = [
    "method" => "ideal",
    "amount" => [ "currency" => "EUR", "price" => 5.00 ],
];
$json_data = json_encode($a_data);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json_data);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key", "Content-Type: application/json"));
$output = curl_exec($ch);
curl_close($ch);

echo $output;

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-d '{"method":"ideal","amount":{"currency":"EUR","price":5.00}}' \
https://api-test.nextname.nl/v2/finance/deposits

Antwoord:

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

{
  "checkout_url": "https://checkout.buckaroo.nl/html/redirect.ashx?r=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "amount": {
    "currency": "EUR",
    "deposit": 5,
    "surcharge": {
      "amount": 0.32,
      "reason": "transaction_fee"
    },
    "vat": {
      "amount": 1.12,
      "rate": 21
    },
    "total": 6.44
  }
}

Betaalkosten vooraf opvragen (quote)

Voordat je een storting aanmaakt, kun je met een quote opvragen of er betaalkosten van toepassing zijn en wat het totaalbedrag wordt. De quote maakt geen storting aan en levert dezelfde amount-opbouw als het antwoord hierboven, maar zonder checkout_url. Ontbreekt surcharge in het antwoord, dan zijn er voor de gekozen methode en het gekozen bedrag geen betaalkosten.

URL parameters

Beschrijving:
Vraag de betaalkosten op voor een storting van € 5,00 via iDEAL.

• PHP
• cURL

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/finance/deposits/quote?method=ideal&amount[currency]=EUR&amount[price]=5.00";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key"));
$output = curl_exec($ch);
curl_close($ch);

echo $output;

curl -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
"https://api-test.nextname.nl/v2/finance/deposits/quote?method=ideal&amount[currency]=EUR&amount[price]=5.00"

Antwoord:

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

{
  "amount": {
    "currency": "EUR",
    "deposit": 5,
    "surcharge": {
      "amount": 0.32,
      "reason": "transaction_fee"
    },
    "vat": {
      "amount": 1.12,
      "rate": 21
    },
    "total": 6.44
  }
}