API Reference

Buy Now Pay Later


Payment


BNPL is one of the payment methods available in the create payment service. There are two checkout options available, redirect and transparent checkout.


Status

Status

Reason

Description

Opened

The order was created.

Waiting

FirstPayment

The order was created and is now awaiting the first payment.

Waiting

EmailValidation

The order was created and is now awaiting email validation.

Pending

ProviderReview

The order was created and is now pending provider review.

Collected

The order was created and paid for.

Cancelled

The order was either canceled or expired.

Failed

The order creation has failed.

Failed

Rejected

The credit order was denied.

When the order status changes a webhook notification will be sent.


Workflow

Each BNPL checkout option has its own workflow. Here you can find more information on the different scenarios.


BNPL Redirect

Applicable:


662
Not applicable:


677
Provider review:


706
Email validation:


701
Expired:


683

BNPL Transparent checkout

Applicable:


706
Not applicable:


716
Provider review:


706
Email validation:


706
Expired:


706

Testing environment

In order to test all scenarios in a testing environment, you can use the order amount to force the order status. It works both with redirect and transparent checkout. In the table below, you can find all the options.

Amount

Primary status

Secondary status

Final status

1 < Amount <= 2.500

type: Pending
reason: ProviderReview

type: Waiting
reason: FirstPayment

type: Collected

2.500 < Amount <= 5.000

type: Pending
reason: ProviderReview

type: Failed

5.000 < Amount <= 7.500

type: Waiting
reason: FirstPayment

type: Collected

7.500 < Amount <= 50.000

type: Waiting
reason: EmailValidation

type: Waiting
reason: FirstPayment

type: Collected

Amount > a 50.000

type: Failed
reason: Rejected

When the order status changes a webhook notification will be sent.