rdl-disbursements

To do disbursement, you will need to hit this API through your Backend:

API Request

Type	Value
HTTP Method	POST
API endpoint (Sandbox)	https://api-sandbox.doku.com/sac-rdl/v1/rdl-disbursements
API endpoint (Production)	https://api.doku.com/sac-rdl/v1/rdl-disbursements

Here is the sample of request header for RDL Disbursement:

Client-Id: MCH-0001-10791114622547
Request-Id: b6a465ea-bb65-48b2-a22b-3e8fb51cf22e
Request-Timestamp: 2020-08-11T08:45:42Z
Signature: HMACSHA256=vl9DBTX5KhEiXmnpOD0TSm8PYQknuHPdyHSTSc3W6Ps=

Request Header Explanation

Parameter	Description
Client-Id	Client ID retrieved from DOKU Back Office
Request-Id	Unique random string (max 128 characters) generated from merchant side to protect duplicate request
Request-Timestamp	Timestamp request on UTC time in ISO8601 UTC+0 format. It means to proceed transaction on UTC+7 (WIB), merchant need to subtract time with 7. Ex: to proceed transaction on September 22th 2020 at 08:51:00 WIB, the timestamp should be 2020-09-22T01:51:00Z
Signature	Security parameter that needs to be generated on merchant Backend and placed to the header request to ensure that the request is coming from valid merchant. Please refer to this section to generate the signature

Here is the sample of request body to create the account:

{
    "transaction": {
        "id": "transaksi-sandbox-01",
        "amount": 300000000,
        "description": "testuat"
    },
    "source_account": {
        "account_id": "2340211124151729152107164433893000196019"
    },
    "account_destination": {
        "code": "BNINIDJA",
        "account_bank_number": "0115471119",
        "account_bank_name": "pk ROBERT NARO ROBERT NARO",
        "address": "JAKARTA"
    }
}

Request Body Explanation

Parameter	Type	Mandatory	Description
transaction.id	string	Mandatory	Unique ID provide by merchant, for reconciliation purpose. Allowed chars: alphabetic, numeric, special chars Allowed Symbol: -, :, ., _ Max Length: 64
transaction.amount	integer	Mandatory	Amount of funds merchant wish to transfer. Min amount : 10000, Max amount : 999.999.999.999
transaction.description	string	Mandatory	Description of transfer, provide by merchant Max Length: 256
source_account.account_id	string	Mandatory	Account ID of your customer that given by DOKU when register for RDL Max Length: 100
account_destination.code	string	Mandatory	Account number of the destination you wish to transfer funds to Max Length: 50
account_destination.account_bank_name	string	Mandatory	Name of the account holder, as per the banks records. Used for verification and error/customer support scenarios Max Length: 50
account_destination.account_bank_number	string	Mandatory	Account number of the destination you wish to transfer funds to Max Length: 100
account_destination.address	string	Mandatory	Address/City name of the destination you wish to transfer funds to Max Length: 50

API Response

After hitting the above API request, DOKU will give the response.

Type	Value
HTTP Status	200
Result	CREATED

Here is the sample response header:

Client-Id: MCH-0001-10791114622547
Request-Id: b6a465ea-bb65-48b2-a22b-3e8fb51cf22e
Response-Timestamp: 2020-08-11T08:45:42Z
Signature: HMACSHA256=1jap2tpgvWt83tG4J7IhEwUrwmMt71OaIk0oL0e6sPM=

Response Header Explanation

Parameter	Description
Client-Id	Same as the request
Request-Id	Same as the request
Response-Timestamp	Timestamp Response on UTC with format ISO8601 UTC+0 from DOKU
Signature	Signature generated by DOKU based on the response body

Here is the sample of response body:

{
    "transaction": {
        "amount": 10000,
        "description": "Test disbursement 100",
        "status": "PENDING",
        "create_date": "2021-04-16T01:24:13Z",
        "update_date": "2021-04-16T01:24:13Z",
        "id": "TRX-102"
    },
    "source_account": {
        "account_id": "2226210210084257767192168810150000152843"
    },
    "account_destination": {
        "account_bank_number": "1234567890",
        "account_bank_name": "Arip Hidayat",
        "code": "CENAIDJA",
        "address": "JAKARTA"
    }
}

Response Body Explanation

Parameter	Type	Mandatory	Description
transaction.id	string	Mandatory	Unique ID provide by merchant, for reconciliation purpose.
transaction.amount	integer	Mandatory	Amount of funds merchant wish to transfer.
transaction.description	string	Mandatory	Description of transfer, provide by merchant
source_account.account_id	string	Mandatory	Account ID of your customer that given by DOKU when register for RDL
account_destination.code	string	Mandatory	Account number of the destination you wish to transfer funds to
account_destination.account_bank_name	string	Mandatory	Name of the account holder, as per the banks records. Used for verification and error/customer support scenarios
account_destination.account_bank_number	string	Mandatory	Account number of the destination you wish to transfer funds to
account_destination.address	string	Mandatory	Address/City name of the destination you wish to transfer funds to