How transfers work
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/utility/banks | Get list of supported banks |
| POST | /api/v1/business/validate | Validate a recipient’s bank account |
| POST | /api/v1/business/single | Initiate a single transfer |
| POST | /api/v1/business/bulk | Initiate a bulk transfer |
| GET | /api/v1/business/status | Check transfer status |
| POST | /api/v1/business/fee/single | Calculate fee for a single transfer |
| POST | /api/v1/business/fee/bulk | Calculate fees for a bulk transfer |
Transfer flow
Before initiating any transfer, you should validate the recipient’s account. This confirms the account exists and returns the account holder’s name, so you can verify the details before sending money.Fees
Transfer fees are calculated based on the transfer amount. Use the fee calculation endpoints to show your users the exact cost before they confirm a transfer. Fees include:- Numero fee — the fee you’re charged for the transfer
- Stamp duty — NGN stamp duty (₦50 on third-party NGN transfers ≥ ₦10,000), a government levy passed through at cost