HwebPay Logo
HwebPay
Docs Banks & Accounts

Banks & Account Resolution

Utility endpoints to help you build a seamless transfer experience. Retrieve the list of supported banks and verify account details before initiating a transfer.

List Banks

Get a list of all banks supported for transfers. You should use this to populate the bank dropdown in your UI.

GET /banks
Endpoint
Response Example
{
  "status": "success",
  "data": [
    {
      "name": "Access Bank",
      "code": "044"
    },
    {
      "name": "Guaranty Trust Bank",
      "code": "058"
    },
    ...
  ]
}

Resolve Account

Verify an account number to ensure it belongs to the intended recipient. This step is highly recommended before initiating any transfer to prevent errors.

POST /accounts/resolve
Endpoint

Parameters

Param Type Required Description
bank_code string Yes The 3-digit bank code.
account_number string Yes The 10-digit account number.
Response Example
{
  "status": "success",
  "data": {
    "account_name": "JOHN DOE",
    "account_number": "0123456789",
    "bank_code": "058"
  }
}

© 2026 HwebPay Docs Portal

Developer Community