Dark Mode

Submit Disbursement API


The following endpoint submit a disbursement:

/disbursements/submit

Run in Postman

Request Header Attributes

Following are the parameters to be sent in the request header:

idempotency_key

String
Mandatory

The idempotency key used to submit the disbursement. It will be used to prevent accidentally creating the same disbursement more than once.

Path Attributes

force_disburse

Boolean
Optional

If this parameter is true then the batch will be validated and disbursed. In this case, approve API doesn't need to be called. Default value: false

skip_validation

Boolean
Optional

If this parameter is true then the bank validation will be skipped and items will be disbursed directly. This parameter should only be used if force_disburse is set to true . Default value: false

Request Body Attributes

Following are the parameters to be sent in the request body:

name

String
Mandatory

The name given for the disbursement batch to be submitted.

description

String
Mandatory

The description for the disbursement batch.

account_owner_name

String
Mandatory

The name of the bank account holder.

bank_code

String
Mandatory

The bank code of the account.

amount

String
Mandatory

The amount of money to be disbursed.

account_number

String
Mandatory

The account number of the recipient.

email_recipient

String
Mandatory

The email of the recipient.

phone_number

String
Mandatory

The phone number of the recipient.

notes

String
Optional

The notes for the disbursement if any.

Example
curl -u [Base64({Your_Server_Key}:)] \
-X POST https://api.durianpay.id/v1/disbursements/submit \
-H "content-type: application/json" \
-H "idempotency_key: <YOUR_IDEMPOTENCY_KEY>" \
-d '{
  "name": "sample disbursement",
  "description": "this is a sample disbursement",
  "items": [{
      "account_owner_name": "Jane Doe",
      "bank_code": "bca",
      "amount": "10000",
      "account_number": "8422647",
      "email_recipient": "jane_doe@nomail.com",
      "phone_number": "85722173217",
      "notes": "salary"
  },
  {
      "account_owner_name": "Jack",
      "bank_code": "bca",
      "amount": "10000",
      "account_number": "235464",
      "email_recipient": "jack@nomail.com",
      "phone_number": "85609873209",
      "notes": "salary"
  }]
}'

Response Code

200 - Success

1
2
3
4
5
6
7
8
9
{
    "data": {
        "id": "dis_LjxhDKq8Am3427",
        "name": "test disb",
        "total_amount": "20000.00",
        "total_disbursements": 2,
        "description": "description"
    }
}

400 - Invalid Request

401 - Unauthorized Access

403 - Invalid Request

500 - Internal Server Error