Payouts enable you to make disbursements to customers for whom you don’t have destination bank account details. You can use our payout links to collect the fund account details and then process refunds, reimbursements, or cashbacks automatically.
Typically, to pay out to a customer, you would need to reach out to your customer to get their bank details, have multiple contacts to confirm those details, then have the finance team manually process the disbursement.
With Payouts, you can minimize the operational hassle of gathering bank details from customers. Our Payouts feature is built on top of our Xendisburse API, which allows bank transfers to more than 140+ banks in Indonesia. We also allow transfers to OVO and GOPAY.
While most of our customers use Payouts for refunding transactions, there are many others including deposit returns, paying out staff, giving bonuses, and cashbacks.
Creating a payout will be very simple and easy. You can choose to create it via your dashboard, or set up the API integration to send the URL. All of your payouts will be displayed on the dashboard along with their status and details.
Creating a payout via Xendit dashboard is very simple. First, go to your dashboard and open the Payouts tab. Click on the Create Payout button there, which will show:
Parameter | Description |
External ID | Unique code for you to reconcile. e.g.:Refund-Payouts-123XXXXX |
Amount | Payout total amount in Rupiah |
Recipient Email | customer@domain.com |
After you create a payout, an email will be generated and sent to the Recipient Email. This email contains instructions, a password, and a link to the payout UI.
An example API request is available in our Postman Library.
Parameter | Description |
External ID | Unique code for you to reconcile. e.g.:Refund-Payouts-123XXXXX |
Amount | Payout total amount in Rupiah |
Recipient Email | customer@domain.com |
After the recipient receives the payout link via email, they need to fill in their bank details and complete a verification.
Parameter | Description |
Destination Bank | You can choose up to 140+ banks that can be served via Xendit, including GOPAY, and OVO. List of Bank Codes. |
Account Name | The recipient’s name. |
Account Number | The recipient’s bank account number for the transfer |
Secret Password | The secret password that is found in the email. |
Above is what your user will see after the payout refund has been completed
There are two ways you can monitor the status of a payout:
Xendit Payouts tab dashboard
API / Callback
You are able to use a GET Status for the particular payout that you have generated. Use this method if you would like to receive the confirmation of the status of your payout to display the information on your website/app.
Xendit will also send the status to you for transfer through our Disbursements callback. Please set up your Disbursements callback URL to handle the transfer status.
Below are the statuses that you might might see both on the Dashboard, and the GET URL
Status | Description |
PENDING | The payout URL has been created, but the transaction has not been successfully disbursed. Kindly refer to the Disbursement status of the transfer for further information. |
COMPLETED | Funds successfully disbursed to the recipient bank account. |
FAILED | The payout has failed. The reason is described in failure_reason field. This can include expiring without being claimed, locking due to password failures, or an issue with the bank disbursement |
VOIDED | The payout has been voided. This issue is raised because the payout has been expired or manually voided by hitting the void endpoint. |
You are able to test our payout features in development mode. The following conditions must be met for the payout testing:
Scenario | Parameter: Value |
Successful Payout Will complete payment and initiate callback API to your callback URL with status: “COMPLETED” | amount: 90000 |
Please note that the testing will only trigger after you have inputted the secret passkey from your email in the payout link. You may also find the testing scenarios based on the Disbursements testing simulation.
We are always looking to improve, and would love to hear your thoughts and feedback - please send us an email to payouts-feedback@xendit.co