REST API

Documentatie

PHP C# HTTP

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.

Lees meer over het verdienmodel in onze FAQ.
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, in het veld checkout.setupUrl. De prijzen zijn per product instelbaar via je account, onder het kopje Betaalscherm.

Request: 
POST /v2/checkout/5L2zKMnOqp6A15GoP909Z HTTP/1.1
Authorization: Bearer TOKEN
Accept: application/json
Content-Type: application/json

{
  "returnUrl": "http://localhost/voorbeeld?order_id=83432183",
  "billing": {
    "address": {
      "name": "John Doe",
      "line1": "Osloweg 75",
      "postCode": "9700 GE",
      "city": "Groningen",
      "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

In de API response staat een veld genaamd paymentUrl. Verwijs jouw gebruiker door naar deze URL: dit is het betaalscherm voor de bestelling. In de testomgeving kom je op het testbetaalscherm — daar hoef je natuurlijk geen echte betaling te voldoen.

Response: 
HTTP/1.1 201 Created                 
Content-Type: application/json;charset=UTF-8
Content-Length: 508
Location: https://test.printapi.nl/v2/checkout/5L2zKMnOqp6A15GoP909Z
            
{                               
  "status": "Open",
  "amount": 22.49,   
  "paymentUrl": "https://test.printapi.nl/v2/payments/0WIqo9FoUv2xwMI6Bzuo/start",
  "returnUrl": "http://localhost/voorbeeld?order_id=83432183",
  "billing": {
    "address": {
      "email": "info@printapi.nl",
      "name": "Print API",
      "line1": "Osloweg 75",
      "postCode": "9700 GE",
      "city": "Groningen",
      "country": "NL"
    }
  }
}

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.

Request: 
GET /v2/orders/83432183 HTTP/1.1
Authorization: Bearer TOKEN
Accept: application/json

Je vindt de bestaalstatus in het veld checkout.status van de API response. Je kunt daar ook de paymentUrl terugvinden, onder checkout.paymentUrl. Bekijk de API reference voor meer informatie. De volgende betaalstatussen kunnen voorkomen:

Statussen:
"Open" De betaling is onvoltooid. De paymentUrl blijft 24 uur beschikbaar.
"Successful" De betaling is gelukt.
"Cancelled" De paymentUrl is verlopen en de bestelling is geannuleerd.
Print API heeft ook webhooks om je server automatisch op de hoogte te stellen van statuswijzigingen. Daarover meer in de volgende stap.

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.

Volgende