Skip to main content

Create Disbursement

Use this API to start disbursing money to a specific beneficiary account.

Request#

POST

/gateway/cash

Parameter#

application/json

FieldTypeDescription
merchantCodestring [5..50] charactersUnique merchant code
orderNumstringThis number should be unique for merchant. Dupliated numbers won't be accepted by platform.
moneystringamount to transfer.
descriptionstring <=32 charactersdescription of the bill
namestring <=32 charactersreal name of user that left in bank.
bankCodestringbank short name
numberstringbank card number of user.
notifyUrlstring <url>Asynchronous notification address, which is used to receive asynchronous notifications of successful transfer
feeTypestringEnum: 0 1
How to charge the transaction:
- 0 Deducted from the transfer amount
- 1 Deducted from the merchant balance
dateTimestring <date-time>format yyyyMMddHHmmss
signstring <=512 charactersEncrypted parameters.

Request Example#

{
"merchantCode": "S2020198627344",
"orderNum": "T202007183457183",
"money": "10000",
"description": "iPhone11",
"name": "Asmana",
"bankCode": "014",
"number": "1208930430392",
"notifyUrl": "https://www.merchant-server/callback/transfer",
"feeType": "0",
"dateTime": "2019-08-24T14:15:22Z",
"sign": "MIGfMA0GCSqGSI...w1ypbiy7VhIoFJbgSYSSHdC"
}

Response#

Success#

200 application/json

FieldTypeDescription
platRespCodestringresult code: "SUCCESS" "FAIL" "UNKNOWN" "NOTEXIST" "ERROR"
platRespMessagestringdescription of resp code
platOrderNumstringunique order number in platform wide.
orderNumstringunique order number in merchant wide. Same as orderNum in request body.
namestring <= 32 charactersThis name will be displayed on bill page when user pay to the VA
bankCodestringbank short name.
numberstringbank card number of user.
moneystringamount to transfer. Only integers are accepted.
feestringfee charged by platform
notifyUrlstring <url>Asynchronous notification address, which is used to receive asynchronous notifications of successful transfer
feeTypestringEnum: 0 1
How to charge the transaction:
- 0 Deducted from the transfer amount
- 1 Deducted from the merchant balance
platSignstringEncrypted response data

Response Example#

{
"platRespCode": "SUCCESS",
"platRespMessage": "success",
"platOrderNum": "BCA_1234567890",
"orderNum": "T202007183457183",
"name": "Asmana",
"bankCode": "014",
"number": "1208930430392",
"money": "10000",
"fee": "0",
"notifyUrl": "https://www.merchant-server/callback/transfer",
"feeType": "1",
"platSign": "MIGfMA0GCSqGSI...w1ypbiy7VhIoFJbgSYSSHdC"
}