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:

  1. The API will return an error message indicating the bank account did not meet the confidence score threshold

  2. The merchant/business will not be created

  3. 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.