Understanding the workflow of a payout

Payouts go through a series of statuses in the payout workflow.

StatusImmutable?Description
pendingNoThe initial state of a payout. Payouts will remain in this state until a crypto address to send the payout to has been input, or the payout request is cancelled.
processingNoAfter a crypto address has been provided by the payer, payouts transition into a processing state.
completeYesOnce the transaction has been registered on the blockchain and has a hash, the payout will transition to complete.
cancelledYesIf the payout is cancelled or fails, the state will transition to cancelled and the funds will remain in the merchant account.
expiredYesThe payment expired before the customer inserted the wallet details.

❗️

Once you finalise a payout, please ensure no more API calls will be made to duplicate the withdrawal - transactions on the blockchain are final and cannot be recalled.

Payment-Out Flow Diagram


What’s Next