How does bank account validation work during merchant onboarding?
Last updated: October 22, 2025
Context
When creating a merchant or business through the API and providing bank account information, our system performs automatic bank account validation using the Account Intelligence tool as part of the onboarding process. This validation helps assess the risk level of the provided bank account before completing the onboarding process.
Answer
The Account Intelligence validation is automatically performed during merchant or business onboarding through our Risk Intelligence API. The system evaluates various parameters to generate a risk score between 0 and 1.
Key aspects of the validation process:
A risk score threshold determines if a bank account is automatically approved
Scores above the threshold allow the merchant/business to be onboarded
Scores below the threshold result in rejection and the merchant/business will not be onboarded
The threshold can be adjusted based on specific program needs
The Account Intelligence model evaluates the following parameters:
Days Since First Seen - Account age serves as a signal of validity
Days Since First Transaction - Transaction history provides stronger validity signal
Has Negative Transactions - Can be a positive signal in context
Has Paid Transactions - Indicates satisfied payment obligations
Has Positive Transactions - Shows expected payment settlement
Name to Match - Helps verify account information
Phone Number Present - Confirms personal data
Valid Routing Number - Validates routing number check digit
If validation fails:
The API will return an error message indicating the bank account did not meet the confidence score threshold
The merchant/business will not be created
You will need to retry the onboarding with a different bank account
Important note: Account Intelligence validation is separate from KYB (Know Your Business) checks, though both must pass for successful onboarding. The validation specifically focuses on bank account risk assessment, while KYB evaluates business verification requirements.