Transfers & Payouts

Send money instantly to any bank account in Nigeria. Numero supports both single and bulk transfers, with real-time status tracking.

How transfers work

Get bank list       →  Fetch the list of supported banks and their codes
Validate account    →  Verify the recipient's account number before sending
Initiate transfer   →  Send money (single or bulk)
Track status        →  Monitor the transfer until it's completed

Endpoints

Method	Endpoint	Description
GET	`/api/v1/business/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

Getting Started