Resolve a Bank Account

Resolve a bank account so you can confirm the account holder name before you attach it to a beneficiary.

When to use this page

Use this page before you add a bank-based beneficiary account so you can verify the destination details first.

Prerequisites

1. Set your NadaPay API base URL in $baseUrl.
2. Export your NadaPay API key as YOUR_API_KEY.
3. Generate a unique idempotency key for the request.

Before you continue

• confirm you are using a bank-based rail
• fetch the correct provider network when the corridor depends on network selection
• collect the account number and network identifier you want to validate

Step 1 — Resolve the bank account

curl --request POST \
  --url $baseUrl/transactions/resolve-bank-account \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency-key: YOUR_UNIQUE_UUID' \
  --data '{
    "accountNumber": "0123456789",
    "networkId": "ntwk_01HXXXXXXXXXXXXXXXXXX"
  }'

Step 2 — Review the response

Response — resolved:

A successful response returns the resolved account holder name and verification status for the submitted account details. Use the response shape shown in the API Reference for this endpoint.

Response — not found:

{
  "statusCode": 500,
  "message": "Internal server error"
}

What success looks like

• the account resolves successfully
• the returned account name matches the intended recipient
• the validation result is acceptable for the bank-based rail you selected

Do not continue if

• the account cannot be resolved
• the resolved account name does not match the intended recipient
• the network ID does not match the bank account details you are validating

Step 3 — Confirm the account name before you continue

Show the resolved account_name to the user or operations team and ask them to confirm it matches the intended recipient. This is a critical step to prevent misdirected transfers.

Once confirmed, add it using Add Beneficiary Account.

✅

Always resolve before adding. Never skip this step for bank account payouts.

What this step returns

• resolved account name
• validation result for the account details you submitted

Save the resolved account information and use it to confirm the destination before you attach the beneficiary account.

Common reasons this step fails

• account number and network ID do not match
• destination account details are invalid
• the selected network does not support the account you are resolving

Call this next

• Create a Beneficiary
• Get Provider Networks for a Country
• Authenticate with x-api-key