Customers are encouraged to take all the following steps before going live to prevent losses and ensure that disbursements are not delayed.
You should always set up your disbursement callback URL to use Disbursements. Set up your callback URL on Dashboard > Settings > Developers > Callbacks.
Upon execution of the disbursement, we send you a callback with the updated status. If the disbursement was successfully executed, we send you a callback notifying you that the disbursement was completed. If the disbursement was not successfully executed, we send you a callback notifying you that disbursement has failed along with the appropriate failure code, to facilitate your decision on whether to send us another request to disburse or return the failure result to your customer.
We have built in idempotency into our Disbursements API to enable you to retry the same request safely without risking a duplicate disbursement.
Be sure to include a unique ID (“idempotency key”) in each disbursement request. In the event of an ambiguous failure of a disbursement (i.e. due to an error in the process, you don’t know whether the disbursement has succeeded or not), you can retry the API call with the same idempotency key until the disbursement verifiably succeeds or fails. If our server receives a call which is a duplicate because the idempotency key already exists in our system, our system will ignore the duplicate request, ensuring the disbursement amount is only deducted once.
We disburse funds on your behalf from our bank accounts. To help your recipient identify funds from you,
Please note that the format and content of the disbursement description in their bank account inquiry or e-wallet statement may vary depending on the bank or e-wallet’s UI.
Upon completion of a disbursement, we send you an API callback with all transaction details, including the following:
You can customize your own payment confirmation UI with the callback information provided.
We provide an automatic email receipt which you can send to your recipient as a notification of transfer. See disbursement receipts.
We display your logo and business details in each receipt. Before sending your first disbursement, you can customize the receipt appearance at Dashboard > Settings > Disbursement Notifications.
You can also customize the email address of the sender of the receipt so that recipients know that the disbursement came from you. To customize the Sender email address and footer message for disbursement and batch disbursement receipts, please go to Dashboard > Settings > Disbursement Notifications and Dashboard > Settings > Batch Disbursement Notifications.
Be sure to test out the receipts by including your email address in the disbursement request. You can then see what the email receipt looks like in your inbox.
You can monitor the status of each disbursement via the Dashboard and via callbacks. We return you a callback when a disbursement has been completed or failed. Alternatively, track the status of each disbursement via the Dashboard > Disbursements.
As you control much of the disbursement experience, we recommend that your recipients reach out to you first with any questions.
If you had customized the email address of the sender of the receipt, your recipient will be able to respond to that email to reach your support team with any questions. To customize the Sender email address and footer message for disbursement and batch disbursement receipts, please go to Dashboard > Settings > Disbursement Notifications and Dashboard > Settings > Batch Disbursement Notifications .
However, your customer may have questions that only we can answer. To provide the most efficient support possible, we recommend that you contact us for these subjects:
If any questions come up which you are unable to answer, reach out to us for help.