Disbursement Statuses

Disbursement status changes based on various scenarios, such as whether the disbursement succeeds or fails. Learn about the different statuses and what to do at each stage of a disbursement's life cycle here.

Status

Description

Pending

  • A Disbursement has been created successfully
  • We will send instructions to make the fund transfers to the specified destination

Processing

  • We have sent instructions to make the disbursement, awaiting confirmation that the bank transfers are complete

Failed

Disbursement failure reasons

  • Disbursements can fail for various reasons.
  • Requested fund transfers can sometimes be declined by the payment network, or a congested payment network may not respond successfully
  • Other reasons could be errors made during the disbursement request. See Handling Errors for a list of possible errors

Handling failed disbursements

  • If you did not receive a response, or the request timed-out, you may attempt to safely retry the disbursement with the same referenceId
  • If a disbursement has failed, take note of the error code and message. Try to rectify any issues with the API request and try again with a new referenceId

Completed

  • The disbursement has successfully completed

Did this page help you?