1. Virtual Account
BPN OpenAPI
  • Get started
    • Introduction to BPN
    • Introduction to API
    • Architecture Overview
    • Authentication
    • Environments
    • Response envelope
    • Idempotency
  • Guides
    • Virtual Account
      • Virtual Account Overview
      • VA · Payin
      • VA · Statuses
      • VA · Currencies & limits
      • VA · Payout
      • VA · RFI
      • VA Opening
        • VND VA Opening
        • BRL VA Opening
    • Wallet
      • Wallet · Transfer
      • Wallet · Assets & limits
      • Wallet · Deposit whitelist
      • Wallet · PaymentLink
      • Wallet Overview
      • Wallet · Deposit
      • Wallet · Statuses
      • Wallet · Withdraw
    • Convert
      • Convert Overview
      • Convert · Quote & submit
      • Convert · Business types
      • Convert · Pairs & limits
      • Convert · Statuses
  • API Reference
    • Virtual Account
      • Virtual Account field notes
      • Inquiry Master VA Balance
        GET
      • List Primary Virtual Accounts
        GET
      • Create Virtual Account
        POST
      • Get Virtual Account Detail
        GET
      • List Virtual Account
        GET
      • List Virtual Account Orders
        GET
      • Get Virtual Account Order Detail
        GET
      • Refund Virtual Account Order
        POST
      • List RFI Sub Virtual Account
        GET
      • Get Sub Virtual Account RFI Template Info
        GET
      • Sub Virtual Account Submit RFI
        POST
      • Add Bank Account
        POST
      • List Bank Account
        GET
      • List Banks
        GET
      • Payout via Virtual Account
        POST
      • Send Email Verify Code
        POST
    • Wallet
      • Wallet field notes
      • Deposit Whitelist
        • Get Deposit Whitelist Options
        • Register Deposit Source Address
        • List Deposit Source Addresses
        • Get Deposit Source Address
        • Disable Deposit Source Address
        • Submit Payer Details for a Received Deposit
        • Save Sub-wallet Payer Profile
        • Update Sub-wallet Payer Profile
        • Get Sub-wallet Payer Profile
        • Get Deposit Whitelist Case
      • Get Asset Balance
      • Get Deposit Address
      • Add Deposit Sender
      • Add Withdraw Whitelist
      • Delete Withdraw Whiltelist
      • Request Withdraw
      • Query Wallet Internal Transfer Detail
      • List Wallet Internal Transfer order
      • Wallet Internal Transfer
      • Create Sub Account
      • Query Transaction History
      • List Wallets
      • List Sub Account
      • Get Transaction Detail
      • List Wallet Transactions
      • Get Wallet Transaction Detail
    • Payment Link
      • Abnormal fund
        • Abnormal funds
        • Matchable Payment links
        • Link Order(Abnormal fund)
        • Submit to platform
      • Create Payment Link
      • List Payment links
      • Get Curreny Network Config
    • Convert
      • Convert field notes
      • Inquery FX Rate
      • Get Stablecoin Quote
      • Create Stable Order
      • Get Order (Single) Detail
      • List Orders(Batch)
    • KYB
      • Share KYB/KYC Info For Sub User
      • Get KYB Sub User Status
    • Reconciliation
      • Get Reconciliation Order List By Page
    • External Provider
      • FE: Create stablecoin collection sub-account link
      • FE: Deposit Travel Rule
      • External Provider · Deposit whitelist
      • Create stablecoin collection sub-account link
      • Get sub wallet account
      • List sub wallet accounts
      • Change sub wallet status
      • Query stablecoin collection order list
      • Query stablecoin collection order status
      • Get quote
      • Accept stablecoin collection order
      • Reject stablecoin collection order
      • Query USD balance
      • USD Payout (withdrawal)
      • Query USD Payout order status
      • Query USD Payout order list
      • Create deposit Travel Rule link
      • Create deposit Travel Rule detail link
    • Mock
      • Mock Virtual account Payin Order
      • Mock wallet deposit transaction
      • Mock Payin Order Refund
      • Mock Payout Order Update Status
    • Pay Session
      • Request Pay Session
    • Files
      • Request File Upload URL
  • Webhooks
    • Webhooks Overview
    • KYB notifications
    • Event catalogue
    • Resend Fail Webhook
    • Open Virtual Account Status
    • Virtual Account Payment Status
    • Virtual Account Invoice update
    • Transaction Status Notification
    • KYB Status Notification
    • Deposit Sender Detail Required
    • Abnormal Fund Notification
    • WALLET_TRANSFER_ORDER_UPDATED
    • Sub Virtual Account RFI Required
    • Sub Wallet Update
    • wallet address whitelist Update
    • Crypto Deposit Order Notification
    • Collect Order Updated
    • Usd Payout Order Updated
    • onboard result
    • partner order status
    • PaymentLink Notification
    • Deposit Whitelist Notification
  • Partner Flow
    • Share KYB/KYC and open account directly
    • Get KYB/KYC submit + open account status
    • Get Stablecoin Quote
    • Create Stable Order
    • Get Order (Single) Detail
    • List Orders(Batch)
    • Submit hash
  • Appendix
    • Enums quick reference
    • Enum
    • Virtual Account(VA) Support List & KYB requirement
  • Release Notes & Changelog
  • Errors
    • Error codes catalogue
  • Change Log
    • 2026-09-21 Virtual Account independent refund orders
    • Wallet deposit source-address whitelist
  1. Virtual Account

List Banks

GET
/v1/account/list-banks
Use this endpoint to retrieve the fiat accounts that have already been maintained under your tenant. It returns the current status, key details, and identifiers so you can review, audit, or reuse them in downstream flows (e.g., Transfer Estimation / Confirm Transfer, Sell).

Request

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v1/account/list-banks?currency=USDT' \
--header 'API-KEY: <api-key>' \
--header 'API-SIGNATURE: <api-key>' \
--header 'API-TIMESTAMP: <api-key>'

Responses

🟢200OK
application/json
Bodyapplication/json

Examples
NGN bank list
{
    "status": 200,
    "code": null,
    "msg": "OK",
    "data": [
        {
            "bankName": "Access Bank",
            "bankCode": "ABNGNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Diamond Bank",
            "bankCode": "DBLNNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Fidelity Bank",
            "bankCode": "FIDTNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "FCMB",
            "bankCode": "FCMBNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "First Bank Of Nigeria",
            "bankCode": "FBNINGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Guaranty Trust Bank",
            "bankCode": "GTBINGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Polaris Bank",
            "bankCode": "PRDTNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Union Bank",
            "bankCode": "UBNINGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "United Bank for Africa",
            "bankCode": "UNAFNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Citibank",
            "bankCode": "CITINGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Ecobank Bank",
            "bankCode": "ECOCNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Heritage",
            "bankCode": "HBCLNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Keystone Bank",
            "bankCode": "PLNINGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Stanbic IBTC Bank",
            "bankCode": "SBICNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Standard Chartered Bank",
            "bankCode": "SCBLNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Sterling Bank",
            "bankCode": "NAMENGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Unity Bank",
            "bankCode": "ICITNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Suntrust Bank",
            "bankCode": "SUTGNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Providus Bank ",
            "bankCode": "PROVNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "FBNQuest Merchant Bank",
            "bankCode": "KDHLNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Greenwich Merchant Bank",
            "bankCode": "GMBLNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "FSDH Merchant Bank",
            "bankCode": "FSDHNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Rand Merchant Bank",
            "bankCode": "FIRNNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Jaiz Bank",
            "bankCode": "JAIZNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Zenith Bank",
            "bankCode": "ZEIBNGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Wema Bank",
            "bankCode": "WEMANGLA",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Kuda Microfinance Bank",
            "bankCode": "KUDANGPC",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "OPay",
            "bankCode": "OPAYNGPC",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "PalmPay",
            "bankCode": "PALMNGPC",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Paystack-Titan MFB",
            "bankCode": "PAYTNGPC",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Moniepoint MFB",
            "bankCode": "MONINGPC",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "Safe Haven MFB",
            "bankCode": "SAHVNGPC",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        },
        {
            "bankName": "BellBank MFB",
            "bankCode": "BELLNGPC",
            "bankCountry": null,
            "type": "bank",
            "bankId": null
        }
    ],
    "traceId": "Auto:b878179c0a41482dba6371cbff54e723",
    "success": true
}
Previous
List Bank Account
Next
Payout via Virtual Account
Built with