Skip to main content
Fiat collections let you receive local currency from your customers and credit it to your company balance. There are two ways to collect: Both use the same API. Create virtual account opens a bank account by default, or a mobile money collection with rail: "mobile_money", and both report payments through the same webhooks. That’s why the API reference lists both under virtual accounts.

NGN virtual accounts

A virtual account is a dedicated Nigerian bank account number assigned to one of your customers. Anyone can pay into it by ordinary bank transfer. Bitnob identifies the deposit and credits your company’s NGN balance, tagged with the account it came through, so you always know which customer paid. It’s the simplest way to receive naira: give each customer their own account number and stop matching transfers to people by hand.

When to use it

How it works

1

Set up the customer

Every virtual account belongs to a customer, and Nigerian regulation requires a verified identity behind it. The customer record must carry a BVN, date of birth, and contact details.
2

Issue the account

One call to Create virtual account returns the account number and bank name to show your customer. Accounts open at Globus Bank.
3

Your customer pays in

The customer sends a bank transfer to the account number. Bitnob credits your NGN balance and tags the deposit with the virtual account.
4

You track the deposit

Each deposit fires a virtual_account.deposit.success webhook. Get account transactions lists everything an account has received.

The NGN collection model

Mobile money collections

A collection asks one payer for one payment. You send the amount and the payer’s phone number, the payer approves a prompt on their phone, and Bitnob credits your company’s KES or UGX balance. The collection then closes. Collections use the same endpoints as NGN virtual accounts, with rail: "mobile_money". They don’t need a customer record or KYC. The full flow, limits and errors are in Collect KES and UGX by mobile money.

Getting access

The Bitnob team enables NGN virtual accounts and NGN trading together once your KYB is complete. There’s no self-serve toggle, and review usually takes 24 to 48 hours after all your documents are in. Until then, virtual account calls in production are rejected. Mobile money collections are enabled separately, for each currency. Until they’re on, creating a collection returns 403 FEATURE_NOT_ENABLED.

Where to go next

Set up virtual accounts

Prepare the customer, issue the account, and test deposits in sandbox.

Collect mobile money

Prompt a payer in Kenya or Uganda, and test both outcomes in sandbox.

Create virtual account

The full request and response schema.

Currencies and amounts

Which unit each product uses, including kobo and cents for virtual accounts.

Convert naira

Trade collected NGN into USDT, USDC, or BTC.