---
title: Merchant onboarding
slug: concepts/cards/reporting-and-compliance/merchant-acquiring-reports/merchant-onboarding
description: Merchant onboarding reporting requirements for compliance, including CSV formats, merchant data, transaction metrics, onboarding status, and settlement details.
createdAt: 2026-09-27T10:14:36.877Z
---

## Merchant onboarding report

Partners must complete this report for each merchant they plan to onboard, update or terminate. This file provides Cross River with the key information we need to keep the program within bank and regulatory requirements.&#x20;

## File delivery and format

Refer here for [file delivery](docId\:i4b_iqAVcQFp9m1611twC) and [file format](docId\:i4b_iqAVcQFp9m1611twC) details.

## Sample merchant onboarding file

The following file contains sample data.  If you have any questions, please be in touch with your onboarding team.

::File{src="https://api.archbee.com/api/presign/4hvUOg5mU1sCngl0n0Has/vDn0lnFsndrcjhTZaYV3l_merchant-onboarding-report-sample.csv" label="Merchant Onboarding Report Sample.csv"}

## Explanation of fields

| Field                                         | Data Type         | Description                                                                                                                                                                                                                                                            | Required/Conditional                                                                    |
| --------------------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| Date Approved                                 | DATE (YYYY-MM-DD) | The date the merchant was approved for payment processing services.                                                                                                                                                                                                    | Required                                                                                |
| MID                                           | VARCHAR           | Merchant Identifier — A unique identification number assigned to the merchant by the payment processor.                                                                                                                                                                | Required                                                                                |
| CAID (PF)                                     | VARCHAR           | Card Acceptor Identifier (Payment Facilitator) — A unique identifier assigned to the merchant under a Payment Facilitator model for transaction routing.                                                                                                               | Conditional - populated for merchants onboarded under a Payment Facilitator             |
| Mastercard ICA                                | VARCHAR           | Interbank Card Association — A unique identifier assigned by MasterCard to the acquiring institution for settlement and reporting purposes.                                                                                                                            | Conditional - populated when the merchant accepts Mastercard                            |
| Visa BIN                                      | VARCHAR           | Bank Identification Number — Assigned by Visa to identify the acquiring institution and is used in transaction routing and settlement.                                                                                                                                 | Conditional - populated when the merchant accepts Visa                                  |
| Merchant Legal Business Name                  | NVARCHAR          | The full legal name of the merchant's business entity as registered with the state or governing authority.                                                                                                                                                             | Required                                                                                |
| TaxID/EIN/SSN                                 | VARCHAR           | The merchant's federal Tax Identification Number (TIN), Employer Identification Number (EIN), or Social Security Number (SSN) used for tax reporting and identity                                                                                                      | Required                                                                                |
| Merchant DBA                                  | NVARCHAR          | The "Doing Business As" name — The trade name or brand name under which the merchant conducts business with customers.                                                                                                                                                 | Required                                                                                |
| Billing Descriptor                            | VARCHAR           | The name or description that appears on a cardholder's credit/debit card statement to identify the merchant transaction.                                                                                                                                               | Required                                                                                |
| URL                                           | VARCHAR           | The merchant's website address or primary online business URL used for verification and consumer reference.                                                                                                                                                            | Conditional - populated for merchants with an online presence or card-not-present sales |
| MCC                                           | CHAR(4)           | Merchant Category Code — A four-digit code assigned by card networks to classify the merchant's business type and the goods/services offered.                                                                                                                          | Required                                                                                |
| Products/Services Description                 | NVARCHAR          | Describe the primary products or services offered by the merchant.                                                                                                                                                                                                     | Required                                                                                |
| Address 1                                     | NVARCHAR          | The primary street address of the merchant's business location (street number, street name).                                                                                                                                                                           | Required                                                                                |
| Address 2                                     | NVARCHAR          | Secondary address line for the merchant's business location (suite number, building, floor, etc.)                                                                                                                                                                      | Conditional - populated if applicable                                                   |
| City                                          | NVARCHAR          | The city or municipality where the merchant's business is located.                                                                                                                                                                                                     | Required                                                                                |
| Region/State                                  | VARCHAR           | The state, province, or region where the merchant's business is located. 2-letter code (e.g., NJ).                                                                                                                                                                     | Required                                                                                |
| Country                                       | VARCHAR           | The country where the merchant's business is located. ISO 3166-1 alpha-2 code (e.g., US).                                                                                                                                                                              | Required                                                                                |
| Postal/ZIP Code                               | VARCHAR           | The postal or ZIP code of the merchant's business address.                                                                                                                                                                                                             | Required                                                                                |
| Phone Number                                  | VARCHAR           | The primary business phone number of the merchant.                                                                                                                                                                                                                     | Required                                                                                |
| Email Address                                 | VARCHAR           | The primary business email address for the merchant.                                                                                                                                                                                                                   | Required                                                                                |
| Primary Merchant Contact Name                 | NVARCHAR          | The full name of the primary contact person at the merchant's business for communications and account management.                                                                                                                                                      | Required                                                                                |
| 1 - Principal Name                            | NVARCHAR          | The full legal name of the first principal owner, officer, or authorized signer of the merchant business.                                                                                                                                                              | Required                                                                                |
| 1 - Principal Address 1                       | NVARCHAR          | The primary residential or personal street address of the first principal.                                                                                                                                                                                             | Required                                                                                |
| 1 - Principal Address 2                       | NVARCHAR          | Secondary address line for the first principal's residential address (apt, suite, unit, etc.)                                                                                                                                                                          | Conditional - populated if applicable                                                   |
| 1 - Principal City                            | NVARCHAR          | The city or municipality of the first principal's residential address.                                                                                                                                                                                                 | Required                                                                                |
| 1 - Principal Region/State                    | VARCHAR           | The state, province, or region of the first principal's residential address. 2-letter code (e.g., NJ).                                                                                                                                                                 | Required                                                                                |
| 1 - Principal Country                         | VARCHAR           | The country of the first principal's residential address. ISO 3166-1 alpha-2 code (e.g., US).                                                                                                                                                                          | Required                                                                                |
| 1 - Principal Postal/ZIP Code                 | VARCHAR           | The postal or ZIP code of the first principal's residential address.                                                                                                                                                                                                   | Required                                                                                |
| 1 - Principal Phone Number                    | VARCHAR           | The personal or direct phone number of the first principal.                                                                                                                                                                                                            | Required                                                                                |
| 1 - Principal Email Address                   | VARCHAR           | The personal or direct email address of the first principal.                                                                                                                                                                                                           | Required                                                                                |
| 2 - Principal Name (if applicable)            | NVARCHAR          | The full legal name of the second principal owner, officer, or authorized signer, if applicable.                                                                                                                                                                       | Conditional - populated if the merchant has a second principal                          |
| 2 - Principal Address 1 (if applicable)       | NVARCHAR          | The primary residential or personal street address of the second principal, if applicable.                                                                                                                                                                             | Conditional - populated if the merchant has a second principal                          |
| 2 - Principal Address 2 (if applicable)       | NVARCHAR          | Secondary address line for the second principal's residential address, if applicable.                                                                                                                                                                                  | Conditional - populated if applicable                                                   |
| 2 - Principal City (if applicable)            | NVARCHAR          | The city or municipality of the second principal's residential address, if applicable.                                                                                                                                                                                 | Conditional - populated if the merchant has a second principal                          |
| 2 - Principal Region/State (if applicable)    | VARCHAR           | The state, province, or region of the second principal's residential address, if applicable. 2-letter code (e.g., NJ).                                                                                                                                                 | Conditional - populated if the merchant has a second principal                          |
| 2 - Principal Country (if applicable)         | VARCHAR           | The country of the second principal's residential address, if applicable.                                                                                                                                                                                              | Conditional - populated if the merchant has a second principal                          |
| 2 - Principal Postal/ZIP (if applicable) Code | VARCHAR           | The postal or ZIP code of the second principal's residential address, if applicable.                                                                                                                                                                                   | Conditional - populated if the merchant has a second principal                          |
| 2 - Principal Phone Number (if applicable)    | VARCHAR           | The personal or direct phone number of the second principal, if applicable.                                                                                                                                                                                            | Conditional - populated if the merchant has a second principal                          |
| 2 - Principal Email Address (if applicable)   | VARCHAR           | The personal or direct email address of the second principal, if applicable.                                                                                                                                                                                           | Conditional - populated if the merchant has a second principal                          |
| Avg Monthly Volume                            | DECIMAL(19,4)     | The merchant's estimated or actual average monthly transaction dollar volume processed through payment cards.                                                                                                                                                          | Required                                                                                |
| Average Ticket                                | DECIMAL(19,4)     | The merchant's estimated or actual average dollar amount per individual transaction.                                                                                                                                                                                   | Required                                                                                |
| High Ticket                                   | DECIMAL(19,4)     | The maximum expected or allowed dollar amount for a single transaction processed by the merchant.                                                                                                                                                                      | Required                                                                                |
| Avg Monthly Transaction Count                 | INT               | The merchant's estimated or actual average number of transactions processed per month.                                                                                                                                                                                 | Required                                                                                |
| Entry Type                                    | VARCHAR(10)       | State whether the merchant information is being added, terminated, or updated. <br />Options: Add, Terminate, Update                                                                                                                                                   | Required                                                                                |
| Termination Date                              | DATE (YYYY-MM-DD) | The date the merchant's processing account was terminated.                                                                                                                                                                                                             | Conditional - populated when Entry Type = Terminate                                     |
| Termination Reason                            | NVARCHAR          | The reason or cause for termination (e.g., fraud, excessive chargebacks, business closure, mutual agreement).                                                                                                                                                          | Conditional - populated when Entry Type = Terminate                                     |
| Network Registration                          | BOOLEAN(Y/N)      | Shows whether the card network(s), such as Visa and Mastercard, require the merchant to be registered before it can process transactions. <br />Y = Yes the merchant must be registered with the card network(s), N No, the merchant doesn't need registration. <br /> | Required                                                                                |
| Pull (Funding) YES/NO                         | BOOLEAN (Y/N)     | Shows whether the merchant is enabled to start card-network pull (funding) transactions. These are Account Funding Transactions (AFTs) that debit a cardholder's card to fund an account.                                                                              | Required                                                                                |
| Push (Disbursement) YES/NO                    | BOOLEAN (Y/N)     | Shows whether the merchant is enabled to start card-network push (disbursement) transactions. These are Original Credit Transactions (OCTs) that credit funds to a recipient's eligible card.                                                                          | Required                                                                                |
| BAI (Business Application Identifier          | CHAR(2)           | A 2-character code from Visa that identifies the business purpose of the merchant's Visa Direct transactions (Original Credit Transactions or Account Funding Transactions). It is assigned during merchant onboarding and program approval.                           | Conditional- populated when Via Direct is enabled                                       |
| Bank Routing                                  | CHAR(9)           | The 9-digit ABA routing transit number (RTN) of the bank that holds the merchant's settlement account. It identifies the receiving bank for settlement deposits.                                                                                                       | Required                                                                                |
| Bank Account                                  | VARCHAR           | This is the account where settled merchant funds are deposited.                                                                                                                                                                                                        | Required                                                                                |

