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, withrail: "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 returns403 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.