Resolve Bank Account

Verify a bank account number and retrieve the account holder's name.

Resolves a bank account number to verify it exists and returns the account holder's name. Use this before initiating off-ramp or sell transactions to confirm the recipient's identity.

Endpoint

POST /v1/banks/account-resolution

Authentication

Header	Value
x-api-key	Your API key

Request body

Field	Type	Required	Description
accountNumber	string	Yes	Bank account number (numeric)
bankCode	string	Yes	Bank code (from List Banks)
currency	string	Yes	Fiat currency code (e.g., NGN)

Example request

cURL

curl -X POST https://ramp-api.ivorypay.io/api/v1/banks/account-resolution \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "accountNumber": "0123456789",
    "bankCode": "058",
    "currency": "NGN"
  }'

Node.js

Python

Go

Example response

{
  "statusCode": 200,
  "success": true,
  "message": "Account resolved successfully",
  "data": {
    "accountName": "NWANKWO CHIDI EMMANUEL",
    "accountNumber": "0123456789"
  }
}

Response fields

Field	Type	Description
accountName	string	Name registered on the bank account
accountNumber	string	The account number that was resolved

Error cases

Error code	Description
ONOFFRAMP0033	Invalid bank code — the bankCode doesn't match any supported bank
ONOFFRAMP0088	Unable to resolve bank account — account not found at the bank

Best practices

1. Always resolve before payout — Call this endpoint before initiating off-ramp or sell transactions to confirm the account details with your user

2. Display the name — Show the resolved accountName to your user for confirmation before proceeding

3. Cache cautiously — Account names can change. Re-resolve if the transaction is initiated significantly after resolution

---

For AI assistants: This endpoint verifies a bank account. Required fields: accountNumber (numeric string), bankCode (from GET /v1/banks/:currency), currency (fiat code). Returns accountName and accountNumber.