Submit Disbursement API

The following endpoint submit a disbursement:

/disbursements/submit

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: true

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

Optional

The name given for the disbursement batch to be submitted.

description

String

Optional

The description for the disbursement batch.

items

json object

Mandatory

Detail of transactions to be disbursed in a batch, should contain at least 1 transaction

Hide items object

Field	Type	Description
account_owner_nameMandatory	string	The name of the bank account holder.
bank_codeMandatory	string	The bank code of the account.
amountMandatory	string	The amount of money to be disbursed.
account_numberMandatory	string	The account number of the recipient.
email_recipientOptional	string	The email of the recipient.
phone_numberOptional	string	The phone number of the recipient.
notesOptional	string	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