Numero Developer Docs

Build scalable fintech products with Numero's robust infrastructure.
Create virtual accounts, manage transfers, and automate payouts with just a few lines of code.

Get API Keys

Contact Support

💸

Transfers & Payouts

Send money instantly to any bank account in Nigeria. Supports single and bulk transfer requests.

🏦

Virtual Accounts

Create dynamic NUBAN accounts for your customers to receive funds via bank transfer.

📜

Transaction History

Retrieve detailed reports and reconcile payments with ease.

🔔

Webhooks

Listen for real-time events like incoming credits or failed transfers.

Authentication

The Numero API uses API keys to authenticate requests. You can view and manage your API keys in the Merchant Dashboard.

Your API keys carry many privileges, so be sure to keep them secret! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, etc.

Authentication to the API is performed via the x-api-key header.

x-api-key: NUMERO_SECRET_KEY

Request Signature

For security, all POST requests (like Transfers) also require a signature in the x-signature-key header. You can read the full guide on generating signatures in the Security & Webhooks section.

Base URLs

All API requests should be made to one of the following base URLs:

Sandbox (Test)https://api-dev.usenumero.com

Production (Live)https://api.usenumero.com

Overview

Numero Developer Docs#

Transfers & Payouts#

Virtual Accounts#

Transaction History#

Webhooks#

Authentication#

Request Signature#

Base URLs#