Sign in

v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Validate Bank Account (Penniless / Penny Drop)

post/core_banking/money_transfer/validate_account

Headers

client_idstring required
client_secretstring required
module_secretstring required

Use the core banking module secret

provider_secretstring required

Request body

reference_idstring required

A specific unique ID assigned by you for this transaction. If not kept unique, transaction status extraction could behave erratically

purpose_messagestring required

The narration that you want to show as a message for the transfer

transfer_amountstring

The amount to be penny dropped. Optional, If not provided, Re. 1 will be considered by default

validation_typestring

The validation method to be passed. Accepted values are "penniless","pennydrop" and "hybrid"

perform_name_matchboolean

A boolean value to be passed if the name passed needs to be compared with the beneficiary name provided for successfull validations. (Optional)

Response

200

OR
OR
OR
OR
OR
OR
OR
OR

Example response

{
  "status": "success",
  "decentroTxnId": "<decentro_txn_id>",
  "responseCode": "S00000",
  "message": "The account has been successfully verified.",
  "accountStatus": "valid",
  "beneficiaryName": "<beneficiary_name>",
  "bankReferenceNumber": "<bank_reference_number>",
  "transactionStatus": "success"
}