API reference
Endpoints available to every Swappr merchant. No additional gating beyond authentication + permissions.
Resources
- Payouts: Send money to recipients. Single payouts, list, retrieve, requery, cancel.
- Batches: Bulk payout creation up to 150 rows per call.
- Wallets: Multi-currency wallets with balances + ledger history + funding events.
- Beneficiaries: Saved recipient management with per-currency rail validation.
- Customers: End-customer records, KYC submission, international-account (VIBAN) issuance, and per-customer transaction history.
- Virtual accounts: Read-only list of merchant-level funding accounts.
- Name enquiry: Resolve NGN account numbers to bank-of-record names via NUBAN.
- Webhook endpoints: CRUD for webhook subscriptions + signing secrets.
- Webhook deliveries: Read-only delivery history with retry attempts.
- Reports: Aggregated reports in JSON, CSV, or XLSX.
- Banks: NG bank list with CBN codes.
Base URL
https://api.swappr.me/api/v1The same hostname serves both sandbox and live environments. We route based on the API key prefix (sk_test_ vs sk_live_).
Common headers
| Header | Required for | Notes |
|---|---|---|
Authorization: Bearer sk_<env>_<secret> | All endpoints | See Authentication |
Idempotency-Key: <unique> | All POST endpoints | See Idempotency |
Content-Type: application/json | POST / PATCH with body | , |