Transfer Funds
Description
Disbursement is used to move or transfer funds to bank accounts in Indonesia. You may be a fintech lending platform transferring loans to borrowers, a major company paying out payroll for thousands of employees across various bank accounts, a platform giving cashback to customers, or an eCommerce business paying out your suppliers - Disbursement is the easiest, the fastest, and the most reliable way to send out your money to your users. We systematically build this so you can do it automatically, and at scale..
Disbursements are done instantly for any banks and any amount inside a payment schedule available. Due to restriction of Indonesian banks however, Instant payouts can only be executed during 08:00-22:00. If you execute payouts outside this schedule, we will execute as soon as the banks are available again (outside maintenance hours of 23:00-04:00).
Try it now
You can easily test out the API below. Test your first disbursement below and see how blazingly fast it is!
Create Disbursement
In this example, together we will create a Disbursement request. You can then see how the flow fits your use case.
Start the test by running the request in CURL via your desktop terminal. You can also edit the parameters to test out different results.
curl https://api.instamoney.co/disbursements -X POST \
-u NIiHfL5xh+amlMdrKLZOTDSWYNGgodl6mXCy+Rxn/2TQ8LWnDgV1gQ==: \
-d external_id=demo_1531960340700 \
-d bank_code=BCA \
-d account_holder_name='Bob Jones' \
-d account_number=1231241234 \
-d description='Reimbursement for shoes' \
-d amount=76000
Disbursement process
How does the recipient identify disbursements sent through Instamoney?
We disburse funds on your behalf from our bank accounts. To help your recipient identify funds from you,
- Include your company name in the description of the disbursement - if the recipient's bank supports this field, the recipient will see this in their bank statement.
- Ask the recipient to look out for "PT SYAFTRACO" in their bank statement.
Implementing disbursement
Follow the steps below to implement our disbursements API
Please follow the CURL request below using the POST
command. This will create a Disbursement request in which will be executed as soon as the request hits our server.
- Curl
- PHP
curl https://api.instamoney.co/disbursements -X POST \
-u NIiHfL5xh+amlMdrKLZOTDSWYNGgodl6mXCy+Rxn/2TQ8LWnDgV1gQ==: \
-d external_id=demo_1475459775872 \
-d bank_code=BCA \
-d account_holder_name='Bob Jones' \
-d account_number='1231241231' \
-d description='Reimbursement for shoes' \
-d amount=17000
k
As you can see, we have went ahead and pre-filled the request with a valid sample API Key for security. Upon signing up for an account later, you will see your specific API key. Only you can open this API Key, so keep it safe!
Once your request hits our server, our server will then return a response. Below is the response example of a successful request. You can refer the errors section to learn more about how we notify you about errors in requests.
Response: 200
{
"id":"57f1ca56bb1a631a65eee65e",
"updated":"2016-10-03T03:02:46.239Z",
"created":"2016-10-03T03:02:46.239Z",
"user_id":"57b4e5181473eeb61c11f9b9",
"external_id":"demo_1475459775872",
"amount":17000,
"bank_code":"BCA",
"account_holder_name":"Bob Jones",
"disbursement_description":"Reimbursement for shoes",
"status":"PENDING"
}
PARAMETER | DESCRIPTION |
---|---|
user_id |
Your instamoney ID as we see you - for internal purposes :P |
external_id |
An ID of your choice we append to all transactions. Often your unique ID like a phone number, email or transaction ID |
amount |
Amount we should send to the recipient |
bank_code |
Code for the relevant bank. Find more bank codes |
account_holder_name |
Bank account name as per the bank's records. Used for verification and error/customer support scenarios |
account_number |
Bank account number. This has to be exact. We will send to this account and we don't take liability for you sending us an incorrect account number. Find out more about error scenarios |
disbursement_description |
This is the description you give us :) The default can be set in dashboard |
status |
PENDING - means we have initiated the transfer but the bank has not returned a successful response yet COMPLETED - the bank has told us they have sent the funds (Note: sometimes the banks are still a bit slow at execution) FAILED - means our payment has failed. Find out more errors scenario |
Once the Disbursement request is executed, we will send callbacks for that transaction, notifying you of the payment status. This is where you need to set up the callback URL to receive our callbacks. Please find the example of the callback content below.
- PHP
<?php
if ($_SERVER["REQUEST_METHOD"] === "POST") {
$data = file_get_contents("php://input");
print_r("\n\$data contains the updated disbursement data \n\n");
print_r($data);
print_r("\n\nUpdate your database with the disbursement status \n\n");
} else {
print_r("Cannot ".$_SERVER["REQUEST_METHOD"]." ".$_SERVER["SCRIPT_NAME"]);
}
?>
Congrats! That's it - you're now set to disburse funds with instamoney.
Learn more
- Read more about testing and troubleshooting via our testing pages
- Read more about handling multiple error scenarios here
Questions?
Still have more questions? We're always happy to help however we can. Shoot us an email or chat to us in live chat.