Ctrl K
Bank Transfer
POST/api/v1/transfer/bank-transfer
Transfer funds to external bank accounts asynchronously.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| amount | integer | Yes | Amount in kobo. |
| account_number | string | Yes | Recipient account number. |
| bank_code | string | Yes | Recipient bank code. |
| reason | string | No | Transfer reason. |
| pin | string | Yes | Your transaction pin. |
1
Request Example
(cURL)
curl -X POST "https://api.piggyvest.business/api/v1/transfer/bank-transfer" \\-H "Authorization: Bearer YOUR_SECRET_KEY" \\-H "Content-Type: application/json" \\-d '{ "amount": 50000, "account_number": "0123456789", "bank_code": "058", "reason": "Payment for services", "pin": "1234"}'2
Success Response(200)
(JSON)
{ "status": true, "message": "Bank transfer is processing"}3
Error Response(400)
(JSON)
{ "status": false, "message": "Invalid bank code"}