Home
Home
  1. Guides
  • Getting started
  • Authentication
  • Webhooks
  • Embeddable widgets
    • Overview
    • Document upload widget
      • Designing an upload flow
  • Guides
    • Verifying a new business
    • Verifying bank accounts
    • Uploading documents
    • Country-specific fields
    • Supported document types
  • API reference
    • Submissions
      • Reports
        • List available report templates
        • Download a report
      • Create new submission
      • Get submission
      • Update submission
      • Update submission status
      • Run a submission pre-flight check
      • Run business verification
      • Get submission checks
      • Delete submission
      • List submissions
    • Documents
      • Public documents API
        • List documents (public)
        • Upload document (public)
        • Get document (public)
        • Delete document (public)
        • Download document file (public)
        • Rerun validations (public)
      • List documents
      • Upload document
      • Get document
      • Delete document
      • Download document file
      • Rerun validations
    • RPC search
      • RPC search
      • Get company with ID
      • Look up company by RFC
      • Search companies by name
      • Download RPC document
    • Utilities
      • Matcher
        • Run name matching
  1. Guides

Verifying bank accounts

Niva evaluates bank account information extracted from uploaded bank statements as part of business verification. The checks that run, and how many statement periods are required, depend on your submission's policy.

1. Confirm your policy#

The bank_account_details check evaluates the statements associated with the business. It is enabled in the default policies for Brazil (br), Chile (cl), and Colombia (co), and disabled by default for Mexico (mx). Your account's policy may differ.
Mexico also supports a separate, optional ownership check for CLABE (Clave Bancaria Estandarizada) accounts. A statement check alone does not mean Niva has verified account ownership with a bank. Contact support@niva.co to confirm the checks enabled for your account.

2. Upload bank statements#

Create new submission for the business, then Upload document for each bank statement. Use the market's bank_statement type and subtype from Supported document types.
For example, upload a Mexican bank statement:
Replace the submission ID and file with your own. Check validation_status and correct any validation_errors before proceeding. If your policy requires several statement periods, upload a statement for each period.

3. Run verification#

Collect the other documents required for the business, then call Run business verification. See Verifying a new business for the run requirements.

4. Read the check result#

After processing, call Get submission checks and find the check whose name is bank_account_details. Its outcome is pass, fail, warn, or unverified; read message for the reason.
The check can report missing account details, insufficient statement periods, failed document checks, or the result of an enabled bank ownership check. An absent check means it was not returned among the completed checks; do not treat absence as a pass.
Get submission checks returns 400 while processing is in progress or no processing result exists. Use Webhooks or Get submission to track progress.
Previous
Verifying a new business
Next
Uploading documents