Create a payout order
Request URL
Method | URL |
---|---|
POST | /api/pay/payout/create/v1 |
Headers
Header Parameter | Description |
---|---|
timestamp | Request timestamp |
nonce | Random string |
country | Country ID |
app_code | Application code |
Request Parameters
Field | Type | Required | Length | Description |
---|---|---|---|---|
merchantOrderNo | String | yes | 32 | Merchant order number |
amount | String | yes | 20 | Payout amount (in IDR), integer only |
bankCode | String | yes | 50 | Bank code |
bankName | String | yes | 50 | Bank name |
accountType | Int | yes | 501: BankTransfer | |
bankAccount | String | yes | 255 | Beneficiary account number |
realName | String | yes | 255 | Account holderโs name |
phone | String | yes | 10-13 | Phone number starting with โ08โ, 10 to 13 digits |
String | yes | 64 | User email address | |
callbackUrl | String | no | 200 | Callback URL for payout result; if not provided, defaults to merchant config |
sign | String | yes | Signature |
{ "merchantOrderNo": "ds111ad111022911111111111131", "realName": "Carlos", "bankCode": "1", "bankName": "BANK", "accountType": 101, "bankAccount": "1234567890123456", "amount": "100000", "callbackUrl": "http://127.0.0.1:8075/sys/dictionary/test", "sign": "YOUR SIGN", "idType": "DNI", "phone": "13175025118", "idCardNumber": "12345678"}
Response Parameters
Field | Type | Required | Length | Description |
---|---|---|---|---|
merchantOrderNo | String | yes | 32 | Merchant order number |
tradeNo | String | yes | Platform order number | |
status | Int | yes | Payout status: 1 = Processing, 3 = Failed (can retry) | |
amount | String | yes | Transaction amount |
{ "code": 200, "data": { "merchantOrderNo": "ds111ad111002911111111111131", "tradeNo": "TF2405220001MX0000048840060444", "amount": "100", "status": 1 }, "msg": "success", "success": true}