REST API
Documentatie
- Nederlands
- English
Betalen
Print API biedt twee manieren om te betalen. Heb je zelf een betaalsysteem waar jouw klanten kunnen afrekenen, dan kun je ervoor kiezen om zelf periodiek een factuur te ontvangen. In dat geval kun je deze stap overslaan.
Optioneel Betaal-links
Om een betaal-link te genereren, POST je de betaalgegevens naar de set-up URL van de bestelling. Die URL staat in de API response bij het plaatsen van de bestelling. De prijzen zijn per product instelbaar via je account, onder het kopje Betaalscherm.
// var order = await client.Orders.PostAsync(...);
var checkout = await client.Checkout.PostAsync(order, _getCheckoutData(order));
Console.WriteLine(checkout.PaymentUrl); // hier kan je klant betalen
private PrintApi.Input.Checkout _getCheckoutData(PrintApi.Output.Order order)
{
return new PrintApi.Input.Checkout
{
ReturnUrl = "http://localhost/voorbeeld?id=" + order.Id,
Billing = new PrintApi.Input.Checkout.BillingInfo
{
Address = new PrintApi.Input.Address
{
Name = "John Doe",
Line1 = "Osloweg 75",
PostCode = "9700 GE",
City = "Groningen",
Country = Country.NL
}
}
};
}
Velden met bijzonderheden:
Naam | Toelichting |
---|---|
"returnUrl" |
De URL waar je klant na de betaling naar terugkeert |
address["country" ] |
Een ISO 3166-1 alpha 2 landcode |
Als jouw gebruiker de betaling voltooit of annuleert, wordt hij of zij terugverwezen naar de returnUrl
die je in de POST hebt opgegeven. Op die pagina kun je de status van de betaling weer uit de API opvragen — zie het
voorbeeld hieronder. Als de betaling nog niet is voltooid, blijft de paymentUrl
gewoon beschikbaar.
var order = await client.Orders.GetAsync(id);
switch (order.Checkout.Status)
{
case PaymentStatus.Successful:
Console.WriteLine("Bedankt voor je bestelling!");
break;
case PaymentStatus.Open:
Console.WriteLine("Betaling nog niet voltooid. Probeer het nogmaals.");
Console.WriteLine(order.Checkout.PaymentUrl);
break;
case PaymentStatus.Cancelled:
Console.WriteLine("De betaling is verlopen.");
break;
}
TIP: Je kunt je klant al laten afrekenen voordat de bestanden zijn aangeleverd. Daar hoeft je klant dus niet op te wachten. Voordelig bij grotere PDF's, of als je de bestanden pas op een later moment genereert. Is een bestelling betaald maar ontbreken de bestanden na 48 uur, dan nemen wij contact op.