Unified BAV - Advanced Check

Introduction

The Unified BAV - Advanced Check API provides enhanced bank account verification capabilities more coverage. The API supports multiple geographies through a unified integration flow, allowing customers to expand coverage without managing separate country level endpoints.

Coverage: Thailand, Peru, Uruguay, Brazil, Mexico, UK, UK(IBAN), Turkey, China Individual, Argentina, Korea, Indonesia, Malaysia, Nigeria, Uganda, Vietnam, Bangladesh, Nepal, Pakistan, India, Europe

Use Cases:

Cross-Border Transactions:

Facilitate cross-border transactions by quickly and accurately verifying bank account details, enabling secure and efficient international money transfers.

Enhanced Onboarding Process:

Streamline the customer onboarding journey by automating the bank account verification process, reducing manual efforts, and minimizing the risk of errors.

Risk Mitigation:

Minimize the risk of fraudulent activities by validating bank account details through a robust and reliable verification process, providing an additional layer of security.

Currency Confirmation:

Obtain information on the currency associated with the provided bank account, allowing businesses to ensure compatibility and accuracy in financial transactions.

Bank Account Validation Flow

API description

Sample cURL

Pre-Production

Production

curl --location 'https://api-preproduction.signzy.us/api/v3/global-bank-verification/advanced-check' \
--header 'Authorization:' \
--header 'Content-Type: application/json' \
--data '{
    "countryCode": "CN",
    "fullName": "ABBAS AL-SHEIKH",
    "accountNumber": "",
    "clearingSystemId": "",
    "creditorIdentifier": "1234631235",
    "creditorIdentifierType": "NATIONAL_ID",
    "isBusiness": false
}'

curl --location 'https://api.signzy.us/api/v3/global-bank-verification/advanced-check' \
--header 'Authorization:' \
--header 'Content-Type: application/json' \
--data '{
    "countryCode": "CN",
    "fullName": "ABBAS AL-SHEIKH",
    "accountNumber": "",
    "clearingSystemId": "",
    "creditorIdentifier": "1234631235",
    "creditorIdentifierType": "NATIONAL_ID",
    "isBusiness": false
}'

Request Data Parameters

Parameter	Data Type	Required	Description
countryCode	string	Yes	Must be one of the advanced-check supported countries.
fullName	string	Yes	Full name of the individual or business. Maximum 250 characters and must contain at least one letter.
accountNumber	string	Yes	Creditor's account number. Required for all countries. Format varies by country.
clearingSystemId	string	Conditional	Required for IN, BD, NP, PK, ID, NG, UG, VN, KR, UY, TH. For GB, required only when using the sort-code path (not for IBAN). Not required for MY, AR, CN, EU, MX, PE, or BR.
creditorIdentifier	string	Conditional	Required for BR (formatted CNPJ). Optional or ignored for all other advanced-check countries.
creditorIdentifierType	string	No	Not used in Advanced Check.
isBusiness	boolean	Conditional	Required for CN. Optional for all other countries and defaults to false.

Country-Specific Requirements

Country	clearingSystemId	creditorIdentifier	isBusiness
IN	Yes	No	No
BD	Yes	No	No
NP	Yes	No	No
PK	Yes	No	No
ID	Yes	No	No
NG	Yes	No	No
UG	Yes	No	No
VN	Yes	No	No
KR	Yes	No	No
UY	Yes	No	No
TH	Yes	No	No
GB	Yes (unless IBAN)	No	No
MX	No	No	No
PE	No	No	No
AR	No	No	No
EU	No	No	No
MY	No	No	No
BR	No	Yes (CNPJ)	No
CN	No (optional, business only)	No (optional, business only)	Yes

Sample Response

{
  "result": {},
  "reason": "Data not Found",
  "code": "S003"
}

Success Response Body Parameters

Parameter	Data Type	Description
result	object	Verification result payload. Returns an empty object ({}) when the account is not found (code: S003).
result.description	string	Human-readable verification outcome (e.g., Bank Account Verified, Account flagged, Review required).
result.countryCode	string	Echoes the countryCode provided in the request.
result.matchScore	string	Name-match confidence score between 0 and 1, formatted to two decimal places (e.g., "0.95"). Returns an empty string ("") if the vendor does not provide a score.
result.matchScoreDescription	string	Human-readable interpretation of the match score (e.g., Strong Match, Partial Match).
result.nameMatched	string	Account-holder name returned by the bank or verification vendor.
result.currency	string	Account currency in ISO format (e.g., USD, EUR) when available; otherwise returns an empty string ("").
reason	string	Response status reason. Request Successful for S001; Data not Found for S003.
code	string	Signzy response code. S001 = Account verified, S003 = Account not found.

Error Codes

HTTP Status Code	Error Code	Description
400	E001	Bad Request
401	E101	Unauthorized Access
403	E201	Forbidden
404	E301	Data Not Found
409	E401	Upstream error
429	E501	Rate Limit Exceeded
500	E601	Internal Server Error
503	E701	Service Unavailable
504	E801	Timeout

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!