Our API Docs just got a new look!

Status flow

Understanding the deposit lifecycle

Hosted checkout status flow

Note that the Hosted flow does not create deposits in PENDING status as required payer information is missing in the request.

Status diagram explanation

Status
Description

DECLINED

The DECLINED status is not a status by itself. It means the transaction couldn't be created because of an error with the data, the customer or the merchant configuration. No transaction will change its status from DECLINED.

PENDING

Once the deposit is in PENDING status, it means it was successfully created and we are waiting for the user to complete the transaction.

FOR_REVIEW

FOR REVIEW is a transient status we use to specify that the deposit is under revision.

EARLY_RELEASED

EARLY RELEASED will only be used if you specified it in the deposit request

EXPIRED

The deposit reached it's expiration date and the user did not pay, then the status will change to EXPIRED.*

CANCELLED

If the user doesn't pays, the transaction will be marked as EXPIRED. After 7 days the status will change to CANCELLED. Final status.*

COMPLETED

If the deposit was successfully completed, its status will be set to COMPLETED. Final status.

* There are cases in which the users pays after the deposit expired, or paid an incorrect amount and the deposit gets expired. When that happens manual intervention is required to approve the deposit hence a deposit could change its status from EXPIRED or CANCELLED to COMPLETED.

Deposits status Codes

The status of the deposits are separated into different and very specific categories for you to better handle and know the behavior of your customers.

Status
Description

The deposit is created but the customer hasn't opened the link yet.

The deposit is created and the customer has opened the link but he/she didn't complete the payment flow (select payment method, complete personal details, confirm details) or the provider was unable to process the request.

The deposit is created with all the information required and it is awaiting on customer's payment. It has been marked by you to release it earlier. Please note that the customer hasn't paid yet and the money won't be credited to your balance until the customer's payment is detected.

The deposit is created with all the information required and it is awaiting on customer's payment.

The deposit didn't pass our anti-fraud systems and will be retained until manual review.

The deposit has reached its expiration time and the user didn't pay.

The deposit has been cancelled by the customer or it has been 7 days after the expiration.

The deposit has been completed and the money was credited to your account or to the payer's crypto wallet.

Learn more about how to correctly retrieve deposit status in the API Reference Get deposit status

Last updated

Was this helpful?