Skip to main content
GET
/
usermanagement
/
validate-bank-account
Validate Bank Account
curl --request GET \
  --url https://{tenant}.fincode.software/api/v6/services/usermanagement/validate-bank-account \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <x-auth-token>' \
  --header 'platform: <platform>' \
  --header 'uuid: <uuid>' \
  --data '
{
  "bankCode": "<string>",
  "transactionType": "ACCOUNTPAYMENT",
  "accountNumber": "<string>",
  "accountNumberCountry": "<string>",
  "expectedCurrencyCode": "<string>"
}
'
This endpoint validates the recipient bank account details with the destination bank or provider. It is a critical step in the Bank Transfer flow to ensure funds are sent to the correct account.

​
Request Body

​
bankCode
string
required
The unique code of the bank (retrieved from list-supported-banks).
​
transactionType
string
default:"ACCOUNTPAYMENT"
required
The transaction type. Use ACCOUNTPAYMENT for bank transfers.
​
accountNumber
string
required
The account number to validate.
​
accountNumberCountry
string
required
ISO 3166-1 alpha-3 country code of the account (e.g., NGA).
​
expectedCurrencyCode
string
required
The currency of the account (e.g., NGN).

​
Code Example

cURL
curl -X GET 'https://remitjunction.fincode.software/api/v6/services/usermanagement/validate-bank-account' \
--header 'X-Auth-Token: YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "bankCode": "214",
    "transactionType": "ACCOUNTPAYMENT",
    "accountNumber": "8883968718",
    "accountNumberCountry": "NGA",
    "expectedCurrencyCode": "NGN"
}'

Headers

​
platform
string
default:fincode
required
​
uuid
string
default:200
required
​
X-Auth-Token
string
required

Body

application/json
​
bankCode
string
required
​
transactionType
string
default:ACCOUNTPAYMENT
required
​
accountNumber
string
required
​
accountNumberCountry
string
required
​
expectedCurrencyCode
string
required

Response

200

Validation result