Understanding the workflow of fiat payouts

Fiat payouts progress through various statuses as part of the payout workflow. This document provides a detailed explanation of each status and its role in the process.

StatusDescription
PENDING_APPROVALOptional. This state is returned if payouts from the wallet require approvals. The payout will remain in this state until all approvals are received.
PROCESSINGPayouts will remain in this state until a final response has been received from our processing partners.
COMPLETEDOnce a payout has been successfully completed, the payout will transition to COMPLETED.
FAILEDIf for any reason our processing partners are unable to successfully complete the payout, the payout will transition to FAILED, and funds will remain in the merchant's wallet.
CANCELLEDShould the payment be cancelled, then the status will be transitioned to the CANCELLED state. Funds will be returned to the merchants wallet.
RETURNEDOptional. Should the funds be returned after we have received a response from our processing partners, the payout will be marked as returned and the funds will be returned to the merchants wallet.
ON_HOLDNot implemented, details will be provided when available.

The following diagram shows the possible transitions between states.