Verifying bank accounts

📌

Beta Feature: Bank account verification is currently in active development and may change as improvements are released.

This guide outlines how to verify a business’s bank account using our API. This step ensures that the provided account details are valid, the account exists and the account belong to the same entity.

Step-by-step guide

1. Add Bank Account Details

When creating a new submission, you can include a bank_accounts array to verify one or more bank accounts. This is typically used when a bank statement is not available. If a bank statement is provided, the bank_accounts array can be ommited and bank details will be extracted from the statement.

Only CLABE accounts in Mexico are currently supported.

Use the Create new submission or Update submission endpoint and include the bank_accounts field in the request body.

Example Request Fragment

POST /submissions
{
  "country": "MX",
  "business_type": "legal_entity",
  "legal_name": "Acme Inc.",
  "rfc": "NVA120490XD2",
  ...
  "bank_accounts": [
    {
      "account_type": "clabe",
      "account_number": "123456789012345678"
    }
  ]
  ...
}

If both bank statements and bank accounts are provided, the verification process will combine both.

2. Running the Verification

Once the submission starts processing, the bank account verification will automatically begin as part of that process. This involves confirming the validity and ownership of the provided account number. Verification may take anywhere from a few minutes to several hours to complete.

Make sure you've completed uploading all other required documents and information before running the business verification.

3. Retrieve Verification Results

You can check the verification results by fetching the submission after it has been processed. Use the Get submission endpoint.

Each account in the bank_accounts array will include a verification_status field that indicates the outcome.
Example Response Fragment

{
  ...
  "bank_accounts": [
    {
      "name": "Acme SA de CV",
      "tax_id_number": "NVA120490XD2",
      "account_number": "123456789012345678",
      "account_type": "clabe",
      "bank_name": "Banorte",
      "verification_status": "valid"
    }
  ]
  ...
}

Verification statuses

Status	Description
unverified	Verification process has not started yet
pending	Verification is in progress
incorrect	Provided bank information is incorrectly formatted
failed	Account number does not exist at the bank
invalid	Account exists but does not match the entity name or tax ID
valid	Bank account exists and matches the entity

Support

If you encounter any issues or have questions, please contact our support team at support@niva.co.

Verifying bank accounts

Step-by-step guide#

1. Add Bank Account Details#

2. Running the Verification#

3. Retrieve Verification Results#

Verification statuses#

Support#

Step-by-step guide

1. Add Bank Account Details

2. Running the Verification

3. Retrieve Verification Results

Verification statuses

Support