Resolve account

Resolve bank account

curl --request POST \
  --url https://api.oyapasteaza.com/v1/banks/resolve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountNumber": "0123456789",
  "bankCode": "044"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({accountNumber: '0123456789', bankCode: '044'})
};

fetch('https://api.oyapasteaza.com/v1/banks/resolve', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.oyapasteaza.com/v1/banks/resolve"

payload = {
    "accountNumber": "0123456789",
    "bankCode": "044"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "status": true,
  "message": "<string>",
  "data": {}
}

{
  "status": false,
  "message": "<string>",
  "code": "<string>"
}

POST

banks

resolve

Resolve bank account

curl --request POST \
  --url https://api.oyapasteaza.com/v1/banks/resolve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountNumber": "0123456789",
  "bankCode": "044"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({accountNumber: '0123456789', bankCode: '044'})
};

fetch('https://api.oyapasteaza.com/v1/banks/resolve', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.oyapasteaza.com/v1/banks/resolve"

payload = {
    "accountNumber": "0123456789",
    "bankCode": "044"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "status": true,
  "message": "<string>",
  "data": {}
}

{
  "status": false,
  "message": "<string>",
  "code": "<string>"
}

Use this endpoint to verify a recipient’s bank account and generate a reusable recipientCode. The returned recipientCode can be used to create one or more bank transfers to the same recipient without sending the bank account details again.

Always verify that the returned accountName matches the intended recipient before initiating a transfer.

Endpoint

POST /v1/banks/resolve

Headers

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx
Content-Type: application/json

Request body

Field	Type	Required	Description
`accountNumber`	string	Yes	Recipient bank account number.
`bankCode`	string	Yes	Bank code obtained 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 '{
    "accountNumber": "1234567890",
    "bankCode": "044"
  }'

Successful response

{
  "status": true,
  "message": "Account resolved successfully.",
  "data": {
    "recipientCode": "rcp_7hK2j9xLmQ4",
    "accountNumber": "1234567890",
    "accountName": "JOHN DOE",
    "bank": {
      "code": "044",
      "name": "Access Bank Plc"
    }
  }
}

How account resolution works

List supported banks

Retrieve the supported banks and select the appropriate bank code.

Resolve the recipient

Send the recipient’s account number and bank code to the Resolve Account endpoint.

Verify the account name

Confirm that the returned account name belongs to the intended recipient before proceeding.

Store the recipient code

Save the returned recipientCode and reuse it for future transfers to the same account without resolving again.

Notes

Every successful account resolution generates a reusable recipientCode.
The same recipientCode can be used for multiple transfers to the same recipient.
You do not need to resolve the same account before every transfer unless the recipient changes.
Account names may be returned in uppercase.
The recipientCode is scoped to your merchant account and cannot be used by another merchant.

Next steps

List banks

Retrieve supported banks and bank codes.

Create transfer

Send money using a previously generated recipientCode.

Authorizations

Authorization

string

header

required

Use an sk_test_... key in the playground. Never enter a live key in shared environments.

Body

application/json

accountNumber

string

required

Pattern: ^\d{10}$

Example:

"0123456789"

bankCode

string

required

Example:

"044"

Response

Bank account resolved.

status

boolean

required

message

string

required

data

object

required

Getting Started

Collections

Disbursements

Endpoint

Headers

Request body

Example request

Successful response

How account resolution works

Notes

Next steps

List banks

Create transfer

Authorizations

Body

Response

​Endpoint

​Headers

​Request body

​Example request

​Successful response

​How account resolution works

​Notes

​Next steps

List banks

Create transfer

Authorizations

Body

Response

Endpoint

Headers

Request body

Example request

Successful response

How account resolution works

Notes

Next steps