AfterPay API

Start API Request payment

Before starting the payment, you have to call the Start API. You will get a paymentlink and a transaction ID (for in your database).

Call the next URL with GET or POST:

https://transaction.digiwallet.nl/afterpay/start

With the following parameters (* = required):

If you provided all consumer information in the Start API call, the invoice will be immediately processed by AfterPay. This can result in either a "Captured" invoice or a "Rejected" invoice. In case an invoice is "Captured" the result looks like this:

resultcode   transactionumber|status

Example

000000 12345|Captured

In case an invoice gets "Rejected", the result looks like this:

resultcode   transactionumber|status|reason

Example

000000 12345|Rejected|Leeftijd is onder de 18 jaar

If you did not provide all consumer information in the Start API call, you will get the following result:

resultcode   transactionumber|status|enrichment-url

Example

000000 12345|Incomplete|https://pay.digiwallet.nl/consumer/afterpay/enrich/79895d484eac22asd32d83323089f4723347645728d41282de03ff34ffc27574

Possible result codes:

Invoice Lines Order specification

For AfterPay, it is required to specify each item in the consumers order. The invoicelines parameter covers this concept. It has to be passed as a JSON-encoded array consisting of the following array structure (pseudocode):

[
    0 => [
        'productCode' => '0001-TEST',
        'productDescription' => 'Test Object 1',
        'quantity' => 1,
        'price' => 10.00,
        'taxCategory' => 1,
    ],
    1 => [
        'productCode' => '0002-TEST',
        'productDescription' => 'Test Object 2',
        'quantity' => 2,
        'price' => 15.00,
        'taxCategory' => 1,
    ],
]

As seen above, every element of the array represents an item in the order; amounts are indicated via the quantity key.

Explanation of invoicelines keys:

Enrichment Consumer information

The enrichment page is a form on DigiWallet where the consumer can review their order and provide required information that is missing. The consumer cannot adjust any information that is provided to the Start API call, they will only be shown fields where the information is missing.

Once the form is submitted, the completed invoice will immediately be offered to AfterPay. The consumer will then be shown a screen with the result; the invoice will either be Captured or Rejected. In case the invoice is Rejected, the consumer will be shown the reason why. Afterwards the consumer is led back to the returnurl.

Check API Request payment status

Based on the transaction number you can check if the payment is actually made. After payment, the report URL underwater is invoked by the DigiWallet server. It also mentions the payment status, but for safety reasons we strongly recommend to always ask the status from DigiWallet.

Invoke the following URL with a GET or POST:

https://transaction.digiwallet.nl/afterpay/check

The following parameters (* = required):

If the invoice is successfully captured, you will receive as answer :

Example

000000  8f33ac0f15ab7793b273708ae408c8fb7e2asda58fd12f891ac2b4b7a6c915013|AFP-0000012345|Captured

If the invoice is still lacking consumer information, you will receive as answer :

Example

000000  8f33ac0f15ab7793b273708ae408c8fb7e2asda58fd12f891ac2b4b7a6c915013|AFP-0000012345|Incomplete|https://pay.digiwallet.nl/consumer/afterpay/enrich/8f33ac0f15ab7793b273708ae408c8fb7e2asda58fd12f891ac2b4b7a6c915013

If the invoice has been rejected by AfterPay, you will receive as answer :

Example

000000  8f33ac0f15ab7793b273708ae408c8fb7e2asda58fd12f891ac2b4b7a6c915013|AFP-0000012345|Rejected|Leeftijd is onder de 18 jaar|[{"message":"De consument is onder 18 jaar oud","description":"Het spijt ons u te moeten mededelen dat uw aanvraag om uw bestelling achteraf \n te betalen niet door AfterPay wordt geaccepteerd. This is because your age is under 18. If you \n want to use the AfterPay Open Invoice service, your age has to be 18 years or older.\n Voor vragen over uw afwijzing kunt u contact opnemen met de Klantenservice van AfterPay. Of \n kijk op de website van AfterPay.\n Wij adviseren u voor een andere betaalmethode te kiezen om alsnog de betaling van uw bestelling \n af te ronden."}]

If the call to the Check API failed :

Available in plugins