Ctrl K
Wallet Transfer
POST/api/v1/transfer/wallet-transfer
Transfer funds to another wallet within the system asynchronously.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| amount | integer | Yes | Amount in kobo. |
| wallet_id | string | Yes | Recipient wallet ID. |
| 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/wallet-transfer" \\-H "Authorization: Bearer YOUR_SECRET_KEY" \\-H "Content-Type: application/json" \\-d '{ "amount": 10000, "wallet_id": "923f843a-be7e-494a-bc5d-9f49f4cc640f", "reason": "Gift", "pin": "1234"}'2
Success Response(200)
(JSON)
{ "status": true, "message": "Wallet transfer is processing"}3
Error Response(400)
(JSON)
{ "status": false, "message": "Insufficient funds"}