BPN OpenAPI
  1. Account Management
BPN OpenAPI
  • Getting Started
    • Introduction to BPN
    • Key Concepts & Terminology
    • Architecture Overview
  • Onboarding & Prerequisites
    • Product Demo
    • Sandbox & Test Environment
    • Signature Authentication Mechanism
  • Use Case
    • Transfer
    • Vault
    • On/Off Ramp
    • Compliance (Travel Rule Information Submission)
    • Fiat Collection(BRL PIX for example)
  • API Reference
    • Account Management
      • Inquiry Master VA Balance
        GET
      • Create Virtaul Account
        POST
      • Get Virtual Account Detail
        GET
      • List Virtual Account
        GET
      • Send Email Verify Code
        POST
      • Query bank info by account number
        POST
      • Payout via Virtual Account
        POST
      • Refund Virtual Account Order
        POST
      • Get Virtual Account Order Detail
        GET
      • List Virtual Account Orders
        GET
      • Submit Invoice
        POST
      • Get Invoice list Status
        GET
      • List Banks
        GET
      • Add Bank Account
        POST
      • List Bank Account
        GET
      • List RFI Sub Virtual Account
        GET
      • Get Sub Virtual Account RFI Template Info
        GET
      • Sub Virtual Account Submit RFI
        POST
    • Wallet
      • List Wallets
      • List Sub Account
      • Create Sub Account
      • Wallet Internal Transfer
      • Get Asset Balance
      • Get Deposit Address
      • Add Deposit Sender
      • Add Withdraw Whitelist
      • Delete Withdraw Whiltelist
      • Request Withdraw
      • Query Transaction History
    • FX
      • Inquery FX Rate
    • BPN Transactions
      • Get Stablecoin Quote
      • Create Stable Order
      • Get Order (Single) Detail
      • List Orders(Batch)
    • Reconciliation
      • Get Reconciliation Order List By Page
    • Crypto Payment Link
      • Create Payment Link
      • List Payment links
      • Get Curreny Network Config
    • Mock
      • Mock Virtual account Payin Order
  • Webhooks & Events
    • 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
  • Appendix
    • Enum
    • Virtual Account(VA) Support List & KYB requirement
  • Release Notes & Changelog
    • Version History
  • Schemas
    • walletBalance
    • walletAddress
    • transactionRecord
  1. Account Management

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 --request GET '/v1/account/list-banks?currency='

Responses

🟢200OK
application/json
Body

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