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. Choose the issuing bank with
bank, or leave it out to use the default.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 collection model
Getting access
The Bitnob team enables 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.Where to go next
Set up virtual accounts
Prepare the customer, issue the account, and test deposits in sandbox.
Create virtual account
The full request and response schema.
Currencies and amounts
Which unit each product uses, including kobo for virtual accounts.
Convert naira
Trade collected NGN into USDT, USDC, or BTC.