Skip to main content

Nigeria (NG / NGN)

Nigeria supports bank transfer for OnRamp and OffRamp. Retail customers require BVN fields.

Required retail fields

Discovery

Retail bank institutions come from payment-methods (or catalog payment_methods.bank.providers[]). Do not use GET /partner/banks for Nigeria retail — that path returns deposit-account ledger rails, not retail bank transfer institutions.
Take network_id from methods[].networks[] (or catalog payment_methods.bank.providers[].id) — bank institution names. Quote with type: bank, account_number, account_name, and BVN for retail.
Do not pick ids whose codes look like NGN_ACCOUNT_USDC / USDC_NGN_ACCOUNT (or labels such as “NGN account to USDC” / “USDC to NGN account”). Those are deposit-account ledger rails and require payment_method.entity_id + payment_method.account_id, not retail bank transfer.

Sandbox bank account

Full matrix: Sandbox success & failure. Sandbox only.
Do not use arbitrary account numbers like 0123456789 — orders may remain pending indefinitely on sandbox. Never use these test accounts in production.

OnRamp quote (sketch)

Example network_id above is illustrative — always re-fetch from payment-methods (or catalog) on your environment. Quote response includes payment_instructions with the bank account the customer must transfer to — display before accept. Full copy-paste payloads: Sandbox test payloads.