Skip to main content
Use this endpoint to resolve a recipient’s bank account before you create a bank transfer. Resolving an account helps you confirm that the account number and bank code are valid before money is sent.
Do not create a transfer if the resolved account name does not match the intended recipient.

​
Endpoint

POST /v1/banks/resolve

​
Headers

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx
Content-Type: application/json

​
Request body

FieldTypeRequiredDescription
account_numberstringYesRecipient bank account number.
bank_codestringYesBank code from the list banks endpoint.

​
Example request

curl https://api.oyapasteaza.com/v1/banks/resolve \
  -X POST \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "account_number": "1234567890",
    "bank_code": "044"
  }'

​
Successful response

{
  "status": true,
  "message": "Account resolved successfully.",
  "data": {
    "account_number": "1234567890",
    "account_name": "JOHN DOE",
    "bank": {
      "code": "044",
      "name": "Access Bank Plc"
    }
  }
}

​
How to resolve an account

1

List supported banks

Fetch supported banks and store the bank code values.
2

Collect recipient details

Ask for the recipient’s account number and selected bank.
3

Resolve the account

Send the account number and bank code to the resolve endpoint.
4

Confirm the recipient

Compare the returned account_name with the intended recipient before creating a transfer.

​
Notes

  • Always resolve an account before creating a transfer.
  • Account names may be returned in uppercase depending on the banking provider.
  • Store the resolved account details with your transfer record.
  • Ask the user to confirm the resolved name before proceeding when possible.

​
Next steps

List banks

Retrieve supported banks and bank codes.

Create transfer

Send money to a resolved bank account.