The Disbursement object represents a transaction for the sending out of automated outgoing payments.
To start disbursing money from your account, make sure that you have deposited money into the account before creating the Disbursement objects that will pay out the funds.
The Disbursement object tracks the which account requested the disbursement, the transaction amount, the unique identifier from and to merchant, and will also track the life cycle of the intended disbursement.
The life cycle of a disbursement will be captured, keeping track of the history of disbursement attempts and flow of the statuses.
Disbursement attributes
Attributes | Type | Description |
---|---|---|
id | string | Unique identifier for the object. |
referenceId | string | A unique reference ID used for idempotency purposes. Typically an "order id" or "invoice id". See Idempotent Requests |
amount | string | The disbursement amount to be sent. |
status | enum | The status of the disbursement. |
createdAt | timestamp | Time at which the object was created. |
fees | string | The amount of fees charged to your platform to process this disbursement. |
description | string | An arbitrary string attached to the object. Often useful for displaying to users what the Disbursement was for. |
disbursementMethod | object | The disbursement method used to send out the payment. |
Disbursement object
{
"data": {
"id": "contract_1a2b3c4d5e6f7890",
"type": "disbursement",
"attributes": {
"referenceId": "order_id_123456",
"amount": "10000.0",
"status": "processing",
"createdAt": "2020-03-27T23:59:59+07:00",
"fees": "200.0",
"description": "Payout for delivery.",
"disbursementMethod": {
"type": "bank_transfer",
"bankShortCode": "CIMB",
"bankAccountNo": "0102030405"
}
}
}
}