Payout
Single Payout
Initiate Transfer
Status of transfer object returned will be pending until it's proccessed successfully.
Endpoint: /bank_transfer
Method: POST
Header
| Param | Type | Required? | Decription |
|---|---|---|---|
| authorization | string | Yes | Set value to Bearer SECRET_KEY |
| content-type | string | Yes | Set value to application/json |
| Encryption | string | Yes | Set value to your {Signature_HMAC-SHA-512} output |
Body Param
| Param | Type | Required? | Decription |
|---|---|---|---|
| currency | string | Yes | Specify the currency of the transfer. Defaults to NGN |
| amount | string | Yes | Amount to transfer in currency SET value |
| bank_code | string | Yes | receiver's account bank code (check bank list) |
| bank_name | string | Yes | receiver's account bank name (check bank list) |
| account_number | string | Yes | receiver's account number |
| narration | string | Yes | Transfer naration |
| paymentMode | string | Yes | payment mode is required only curreny is KES |
| serviceCode | string | Yes | service code is required only curreny is KES |
| reference | string | No | If specified, the field should be a unique identifier (in lowercase) for the object. Only -,_ and alphanumeric characters allowed. |
Sample Post
curl https://api.budpay.com/api/v2/bank_transfer
-H "Authorization: Bearer YOUR_SECRET_KEY"
-H "Encryption: Signature_HMAC-SHA-512"
-H "Content-Type: application/json"
-d '{
"currency": "NGN",
"amount": "100",
"bank_code": "000013",
"bank_name": "GUARANTY TRUST BANK",
"account_number": "0050883605",
"narration": "Test transfer"
}'
-X POST
Sample Response
{
"success": true,
"message": "Transfer successfully logged and Processing",
"data": {
"reference": "trf_11044f068j1604",
"currency": "NGN",
"amount": "100",
"fee": "10",
"bank_code": "000013",
"bank_name": "GUARANTY TRUST BANK",
"account_number": "0050883605",
"account_name": "OYENIYI TOLULOPE OYEBIYI",
"narration": "Test transfer",
"domain": "test",
"status": "pending",
"updated_at": "2022-03-29T02:51:01.000000Z",
"created_at": "2022-03-29T02:51:01.000000Z"
}
}