Status flow

Understanding the cashout lifecycle

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 cashout is in PENDING status, it means it was successfully created and that it will be send for processing soon, changing to DELIVERED. It can also be manually changed to ON_HOLD or CANCELLED.
ON_HOLD	A cashout will be created with ON_HOLD status only if specified while creating the cashout with on_hold: true. Otherwise, it can be manually set to ON_HOLD from the Merchant Panel. If a cashout is ON_HOLD, it won't be send for processing until you manually go and set it to PENDING from the Merchant Panel. It can still be CANCELLED.
CANCELLED	It means you didn't want to proceed with the cashout and it was CANCELLED through the Merchant Panel or through the Cancel Cashout Endpoint. Final status.
DELIVERED	As soon as the cashout is sent to the bank for processing, its status will change to DELIVERED. At which point it can't be cancelled anymore.
COMPLETED	If the cashout was successfully completed, its status will be set to COMPLETED. Final status*.
REJECTED	If the cashout was rejected by the bank, its status will be set to REJECTED. Final status.

* There are cases in which the banks confirm that a payout was successfully processed and after a few days, it gets returned by the beneficiary's bank therefore the status on our platform will change to REJECTED as well. Those are corner cases but must be considered.

Cashout status codes

In the cashout status endpoint you will receive a cashout_status code. Below you will find the codes and associated status:

Code	Meaning	Description
0		The cashout was accepted by D24 but it wasn't sent to the bank yet. It can still be Canceled.
1		The money reached the customer's account
2		The cashout was cancelled by you
3		The cashout was rejected by the bank due to invalid bank account, account closed, etc.
4		The cashout was sent to the bank for processing. At this point it can't be cancelled anymore
5		Cashout set to on hold by you. It won't be processed until manually changed again to Pending status