Transfer
Transfers funds to the destination bank account. Ensure Account Inquiry has been called first to validate the account.
Endpoint
POST /api/v1/disbursement/transfer
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| accountNo | string | Yes | Destination account number |
| accountName | string | Yes | Account holder name (must match inquiry) |
| bankCode | string | Yes | Bank code (e.g., BCA, BNI, BRI) |
| amount | number | Yes | Transfer amount (in Rupiah) |
| merchantTrxId | string | Yes | Unique transaction ID from merchant |
| platformTrxId | string | Yes | platformTrxId from Account Inquiry result |
| notifyUrl | string | Yes | Webhook URL to receive transfer status notifications |
Example Request
{
"accountNo": "3831358597",
"accountName": "LOUIS WILLIAM TANOTO",
"bankCode": "BCA",
"amount": 10000,
"merchantTrxId": "{{requestId}}",
"platformTrxId": "2026022109022897500",
"notifyUrl": "https://webhook.site/8043de7b-12ec-44b2-a411-26f67b6b5fd5"
}
Success Response
{
"logId": "FzWm3qcyTnEV7xiRHQhm",
"status": true,
"message": "Request diterima, akan segera diproses",
"data": {
"merchantTrxId": "2026012706571124684829011",
"platformTrxId": "2026012623571680343",
"status": "pending"
}
}
Response Fields
| Field | Description |
|---|---|
| merchantTrxId | Merchant transaction ID |
| platformTrxId | KingsPay platform transaction ID |
| status | Initial status (usually pending). Final status is sent via webhook to notifyUrl |
Webhook
The final transfer status (success/failed) will be sent to your provided notifyUrl. Ensure your webhook endpoint can receive and process notifications.