Ctrl K
Direct Integration
POST/api/v1/pocket/transfer/initiate
Initiates transfer request.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| tag | string | Yes | Pocket tag. |
| amount | integer | Yes | In kobo. |
| narration | string | Yes | Description. |
| reference | string | Yes | Your reference. |
| product_name | string | No | Product name. |
| wallet_id | string | No | Expense wallet ID. |
| meta | object | No | Custom data. |
1
Request Example
(cURL)
curl -X POST "https://api.piggyvest.business/api/v1/pocket/transfer/initiate" \\-H "Authorization: Bearer YOUR_SECRET_KEY" \\-H "Content-Type: application/json" \\-d '{ "tag": "mezigaboshi", "amount": 500000, "narration": "subscription Fee", "reference": "your-unique-reference", "product_name": "my-app", "wallet_id": "6d086bce-58ea-46d0-b77e-e1c398d6de4d"}'In sandbox, add "simulate_for": "failure" to simulate rejection.
Webhook Structure
Success: pocket-transfer.inflow.success
Failure: pocket-transfer.inflow.failed
Examples in original context.
Webhook Signature Validation
Same as main webhooks.