Finance : Invoice payments

Aangemaakt: 20-07-2026

Omschrijving

Maak een betaallink aan voor een openstaande factuur. De call levert een checkout_url terug: de betaalpagina.

Endpoint

POST https://api.nextname.nl/v2/finance/invoices/{invoice_number}/payments
Content-Type: application/json

Pad-parameters

Parameter	Datatype	Verplicht	Omschrijving
invoice_number	String	Ja	Het factuurnummer van de openstaande factuur

Body-parameters

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

Parameter	Datatype	Verplicht	Omschrijving
method	String	Ja	De gewenste betaalmethode: ideal of bancontact

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
checkout_url	String	De URL van de betaalpagina. Stuur de betaler hiernaartoe om de betaling af te ronden

Voorbeeld

Beschrijving:
Maak een iDEAL-betaallink aan voor factuur 2612345 en toon de checkout_url.

PHP
cURL

Opdracht in PHP:

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

$a_data    = [ "method" => "ideal" ];
$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;

Opdracht in cURL:

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-d '{"method":"ideal"}' \
https://api-test.nextname.nl/v2/finance/invoices/2612345/payments

Antwoord:

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

{
  "checkout_url": "https://pay.ideal.nl/transactions/XXXXXXXXXXXXXXXXXXXXX"
}