Sign in

v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Validate Bank Account (V3)

Updated Validate Bank Account with smart provider selection.

post/v3/banking/money_transfer/validate_bank_account

Headers

client_idstring required
client_secretstring required
JWTstring

conditional mandatory; to be passed if no client id, client secret is passed

Request body

reference_idstring required

A URN to be passed by the user for each API request. Alphanumeric values are allowed. Special characters such as “@ # $ % ^ & * ! ; : ~ ` ? = + ) ( apostrophe, double quotes” are not allowed

purpose_messagestring required

The narration/remarks that will be displayed in the beneficiaries bank statement. Minimum length is 5 characters and Maximum length is 255 characters. No special characters allowed.

consumer_urnstring required

A URN created for a consumer must be passed here.

validation_typestring required

The validation method to be passed. The accepted values are: penniless, pennydrop, hybrid

perform_name_matchboolean

To compare the name from the name parameter and beneficiary name from API response and check the name match score.

Response

200

OR
OR
OR
OR
OR

Example response

{
  "decentro_txn_id": "78C85EDB672A4187B99431CA85EFC604",
  "api_status": "SUCCESS",
  "response_key": "success_validation_initiated",
  "message": "Account validation was initaited successfully",
  "data": {
    "beneficiary_name": "someone",
    "account_status": "inconclusive",
    "validation_type": "penniless",
    "validation_message": "The validation process is still pending"
  }
}