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 the expiresAt 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 the maxRetries count and all payment attempts failed.
  • It could transition to SUCCESS if a payment was SUCCESS. 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 .