Introduction

Swappr API

The Swappr API is a REST-over-HTTPS interface for B2B disbursement, multi-currency wallet management, and remittance. Built by Technest Limited, an authorised International Money Transfer Operator licensed by the Central Bank of Nigeria.

What you can do

  • Send money to bank accounts in NGN, GBP, USD, EUR, and Interac email IDs in CAD
  • Manage wallets in multiple currencies with real-time balances and ledger history
  • Provision virtual accounts that fund your wallets across multiple Nigerian and FX rails
  • Save beneficiaries with idempotent upserts and per-currency rail validation
  • Subscribe to webhooks for payout status, virtual account credits, and other lifecycle events
  • Pull reports on payouts, funding, fees, cashflow — JSON, CSV, or XLSX

Quick links

API resources

  • Payouts — send money, list, retrieve, requery, cancel
  • Batches — bulk payout creation up to 150 rows per call
  • Wallets — balances + ledger history + funding events
  • Beneficiaries — saved recipients with per-currency rail validation
  • Virtual Accounts — read-only list of merchant funding accounts
  • Name Enquiry — resolve NGN account numbers via NUBAN
  • Webhook Endpoints — CRUD + signing secrets
  • Reports — aggregated data in JSON / CSV / XLSX
  • Banks — NG bank list with CBN codes

If you’re a remittance / IMTO / MSB / EMI operator with use cases beyond standard B2B disbursement (per-end-user KYC, sender info on every transaction, VIBANs per customer), contact support@the-technest.com — additional capabilities can be enabled on your account after compliance review.

Conventions

  • All money values are returned as string-encoded BigInts in minor units (kobo for NGN, cents for USD, etc.) to avoid float precision loss.
  • All timestamps are ISO 8601 in UTC unless explicitly noted.
  • Field names are snake_case in responses and request bodies.
  • IDs prefixed (po_, bat_, whe_, whd_) are merchant-facing references; cuids without prefix are internal.

Need help?

Getting started