Validate Bank Account

post

https://stagingglobal.decentro.tech/v1/banking/validate_bank_account

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
This API is currently in internal beta and subject to change. The request and response payloads, API endpoint, and validation logic may be updated.

🙌
Important Note
Please use only Staging Credentials on each API Reference page to test the APIs directly from our Documentation.

API Endpoints

Environment
Staging / Sandbox	https://stagingglobal.decentro.tech/v1/banking/validate_bank_account
Production	https://global.decentro.tech/v1/banking/validate_bank_account

🌐
Note
For the country specific validation requirements refer to this.

Body Params

reference_id

string

required

A unique ID assigned by clients for every API request.

consumer_urn

string

required

A unique identifier assigned to client's by Decentro during On boarding.

purpose_message

string

required

Purpose of the transaction

perform_name_match

boolean

required

Defaults to false

If true, Decentro will attempt to retrieve the beneficiary name from the bank and run internal name match against the client-provided name. If false or not provided, only account validation is performed. When true, account_holder.name becomes mandatory.

beneficiary_details

object

required

Details associated with beneficiary

beneficiary_account_details

object

required

Details associated with beneficiary's bank account

beneficiary_bank_details

object

required

Details associated with beneficiary's bank

Headers

client-id

string

required

Decentro assigned client_id during onboarding.

client-secret

string

required

Decentro assigned client_secret during onboarding.

x-on-behalf-of

string

Optional header that allows parent merchant to consume the API on behalf of sub-merchant.

Responses

This API is currently in internal beta and subject to change. The request and response payloads, API endpoint, and validation logic may be updated.

Important Note

API Endpoints

Note

200

400Bad Request

406Not Acceptable