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.