Status Transitions
This page explains the possible status transitions a checkout could go through and what they mean.
Checkout transaction statuses
OPEN
- Checkout has been created. This is the initial status.
PENDING
- Checkout can't make new payment attempts, but the payments are still OPEN
SUCCESS
- Checkout has succeeded.
CANCELLED
- Checkout has not succeeded; cancelled by the consumer.
EXPIRED
- Checkout has not succeeded; expired.
FAILURE
- Checkout has not succeeded; unknown reason.
AUTHORIZED
- Checkout is authorized.
Status Transitions
The diagram below shows all state transitions a checkout could go through.
Once a checkout has been created the status will be OPEN
. While the state of a Checkout is OPEN
a consumer can make payment attempts.
Once a payment is successful, the checkout status will transition to SUCCESS
. This is the happy-flow. At this point the consumer has paid and the funds will eventually make its way to your accounts.
Of course there are other possibilities as you will have seen in the state diagram.
A Checkout can transition from OPEN
to PENDING
if the checkout is about to transition to a final state, but not all payment attempts have had a status update yet.
- It could transition to
CANCELLED
if the consumer has clicked on the cancel button. - It could transition to
EXPIRED
if theexpiresAt
timestamp has been reached and all payments have a non-success final state.expiresAt
only means no new payments can be created. The state transition can happen later. - It could transition to
FAILURE
if all payment attempts failed. This scenario is most likely if a consumer reaches themaxRetries
count and all payment attempts failed. - It could transition to
SUCCESS
if a payment wasSUCCESS
. This scenario is likely if a callback of a successful payment is delayed.
AUTHORIZED
is an odd status. It means that the consumer has authorized a payment, but the confirmation that funds are going to be moved is not yet sent. An example where this can happen is via SEPA Direct Debit
. It could take several hours or days until a confirmation is given. There is nothing left to do for the consumer in this process, so from their point of view they'll be redirected according to the SUCCESS
-flow .
Updated 5 months ago