Skip to main content
Skip table of contents

Adding a Bank Account

All Merchants or Referrers processing on the platform must have at least one US or Canada-based bank account on file. Therefore, new Merchants or Referrers are prompted to enter their bank account during the onboarding process. This document guides you through the process of adding additional bank accounts for Merchants or Referrers who are already boarded or are integrating new bank accounts in the future.

Note

This process and its review period apply to Merchant-level and Referrer-level users.

Bank Account Types and Requirements

All Merchants or Referrers boarded to the platform must have an active US-based bank account on file. A bank account serves two purposes for an entity:

  • Account for Deposits: A required bank account to receive deposits from Available Balance funds

  • Account for Debits: A required bank account to be debited to cover negative balances owed

Merchants or Referrers can use one bank account on file for both payouts and debits, individual bank accounts for deposits and debits, or multiple bank accounts with unique, individual purposes.

Important!

All payouts (disbursements) are processed to your primary bank account. If you want to add a new bank account for receiving payouts, then you must update your primary bank account with the relevant information instead of adding a new bank account.

Bank Account Validation

As a payment facilitator, the Payrix Pro platform validates any bank account submitted by an entity. This validation includes active status, type of account, and ownership and prevents funds from being sent to an incorrect bank account due to a typo or invalid information.

To streamline the validation process, the platform uses Plaid for Merchants or Referrers to link their bank accounts. This process supports instant validation through an integrated portal dialog, where users can securely log in to their bank.

For instances where an entity attempts to manually add new bank information or change existing bank information, follow the manual account validation process below:

Manual Bank Account Validation

If an entity manually submits their bank account information, they must submit supporting documentation to Platform Risk for account validation.

The following documents are acceptable for validating bank accounts:

  • A voided check: This check must not be a starter check or a computer screenshot.

  • A bank letter: This letter should include the bank’s name and phone number, the routing number, your bank account number, and your business name.

  • A bank statement: This statement must display the routing number and account number, and it should not be older than 60 days.

When manually entering information in the portal for a new bank account, like account and routing numbers, you must upload a document before the form can be submitted. This can also be achieved using the API. See the following sections for step-by-step instructions on how to add an account in the portal or using the API.

Important!

A manual review of the supporting documents is required for approval and can take up to five business days.

During the five-day manual review and approval period, all payments processed will still be funded to your Payrix Pro account’s available balance and will be ready for immediate withdrawal to your bank account after validation.


Link a Bank Account with Plaid

With Plaid enabled, Merchants or Referrers are prompted to go through the bank account linking process as they sign up.

Important!

This process requires the Merchant to submit their confidential online banking login and should only be completed by one of the Merchant’s users directly and not by anyone else on the Merchant’s behalf.

To link a new bank account with Plaid:

  1. Access the Merchants page or Referrers page within the Management category.

  2. Select the desired Merchant to bring up their Merchant Profile or Referrer Profile.

  3. Select the Banking tab on the left.

  4. Click ADD NEW ACCOUNT in the upper-right corner.

  5. Click LINK ACCOUNT in the dialog and select the type of usage: Billing, Deposits, or All.

  6. Click LINK NEW ACCOUNT in the dialog to reveal the Plaid integration dialog.

  7. Complete each Plaid prompt:

    1. Click Continue to accept the Plaid End User Privacy Policy.

    2. Click Continue to Login after selecting the information you’d like to share from the checkboxes available to redirect to your banking institution’s online account login.

    3. Select each checkbox next to the banking accounts you’d like to add to your Merchant account and click Continue at the bottom of the lightbox.

    4. Select the Terms and Conditions checkbox to acknowledge and accept the terms and information being shared. Then, click Connect account information.

    5. Click the final Continue button to complete the process.

Important!

Some banking institutions, such as Chase Bank, use a tokenized account number (TAN) for each third-party integration of a user's bank account.

This security practice protects your original bank account and routing numbers by never allowing them to be seen by any third-party integration.

  • If your TAN is ever compromised, a new one can be generated after contacting Chase Bank instead of the more time-consuming process of closing and re-opening a new account.

As a result, the account and routing number shown in the portal will not match your original account and routing number Chase Bank.

This is expected. Contact Chase Bank or visit Chase Bank’s Developer article regarding TANs if you have further questions or concerns.


How to Manually Add a New Bank Account

If an entity’s bank is not eligible for use with Plaid, or to skip the Plaid process, they can manually add a new bank account.

You have two methods for adding a new bank account manually:

  • Use the portal to enter bank account information and upload documentation in the Merchant Profile.

  • Use the API to enter the information using the /accounts endpoint and submit documentation separately.

Note

Manually adding a bank account requires a manual review of supporting documents to approve the addition.

See the manual validation process above for more information on qualifying support documents and the manual review approval period timeline.

Manually Add a New Bank Account in the Portal

The Banking tab within the Merchant Profile is where you can manually update or add new bank account information for a specific Merchant. This option is useful in instances where an entity’s banking institution does not currently integrate with Plaid.

To manually add a new bank account in the portal:

  1. Access the Merchants page within the Management category.

  2. Select the Merchant to bring up their Merchant Profile.

  3. Select the Banking tab on the left.

  4. Click ADD NEW ACCOUNT in the upper-right corner.

  5. Click ADD ACCOUNT MANUALLY in the dialog and view the prompt that’s displayed.

  6. Click Continue on the prompt, then click ENTER ACCOUNT MANUALLY.

  7. Enter the Type of bank account, Routing and Account Number, and Usage options.

    • (Optional) Click ADVANCED OPTIONS to add a bank account name and description.

    • The following table describes all fields for the Add Bank Account form:

Field

Required

Description

Type

Required

From the dropdown menu, select what time of bank account is being added.

Valid Values:

  • Checking

  • Savings

  • Corporate Checking

  • Corporate Savings

Note: It is important to specify if a bank account is a corporate or personal account.

Routing Number

Required

Enter the 9-digit routing number associated with this bank account.

Account Number

Required

Enter the account number associated with this bank account.

Usage

Required

From the dropdown menu, select whether this bank account will be used for deposits, debits, or both (All).

Bank Account Name (Advanced Options)

Optional

You can give the new bank account a custom name to differentiate it from other bank accounts on file.

Account Description (Advanced Options)

Optional

You can use this field to give the bank account a custom description.

  1. Upload one of the qualifying support documents into the Upload and Attach Files field.

  2. Click ADD to complete the process.

Important!

You cannot use a manually added account for up to five business days from update or creation until approved by Underwriting.

Manually Add a New Bank Account using the API

Bank accounts can also be manually submitted using the API by sending a POST request to the /accounts endpoint. In the body of the request, you will include the Entity ID of the Merchant, as well as the data for the below fields. You can find the full description of this resource in our API Reference.

Step 1: Add new account information.

Manually Add a New Bank Account - Example Code Snippet

Visit the Payrix Pro API Documentation for parameter descriptions and valid values.

Request URL & Header

CODE
POST /accounts HTTP/1.1
Accept: application/json
Host: api-test.payrix.com
APIKEY:{{private_api_key}}

Example Request Body

JSON
{
    "entity": "t1_ent_xxxxxxxxxxxxxx",
    "primary": "0",
    "currency": "USD",
    "name":"Bank Account Non-Primary",
    "account": {
        "method": "10",
        "number": "{{New_Account_Number}}",
        "routing": "{{New_Routing_Number}}"
        }
}

Example Response

JSON
{
    "account": {
        "id": "t1_pmt_xxxxxxxxxxxxxxxxx",
        "method": "10",
        "number": "1234567890123456",
        "routing": "123456789",
        "bin": "123456789",
        "payment": null,
        "lastChecked": null,
        "last4": "1111"
    },
    "id": "t1_act_xxxxxxxxxxxxxxxxx",
    "created": "2023-08-18 15:37:56.9284",
    "modified": "2024-08-18 15:37:56.9284",
    "creator": "t1_log_xxxxxxxxxxxxxxx",
    "modifier": "t1_log_xxxxxxxxxxxxxxxx",
    "entity": "t1_ent_xxxxxxxxxxxxxxxxx",
    "token": "ab1234cd5ef67g89012h34567a8b9c01",
    "name": "Bank Account Non-Primary",
    "description": "",
    "primary": "0",
    "status": 0,
    "currency": "USD",
    "inactive": 0,
    "frozen": 0,
    "expiration": null,
    "type": "all",
    "reserved": 0,
    "checkStage": null
}
Step 2: Create a new note associated with the entity (Merchant).

Create a Note Resource to Associate with an Entity and Documents - Example Code Snippet

Visit the Payrix Pro API Documentation for parameter descriptions and valid values.

Request URL & Header

CODE
POST /notes HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: api-test.payrix.com
APIKEY:{{private_api_key}}

Example Request Body

JSON
{
  "login": "t1_log_xxxxxxxxxxxxxxxx"
  "entity": "t1_ent_xxxxxxxxxxxxxxxx",
  "type": "note",
  "data": "ABC Company Bank Account Change Request",
  "note": "Supporting documents for account change.",
}

Example Response

JSON
{
  "id": "t1_not_xxxxxxxxxxxxxxxxxx",
  "created": "2023-10-25T19:10:44.278Z",
  "modified": "2024-10-25T19:10:44.278Z",
  "creator": "t1_log_xxxxxxxxxxxxxxxx",
  "modifier": "t1_log_xxxxxxxxxxxxxxxx",
  "login": "t1_log_xxxxxxxxxxxxxxxx",
  "entity": "t1_ent_xxxxxxxxxxxxxxxxx",
  "type": "note",
  "data": "ABC Company Bank Account Change Request",
  "note": "Supporting documents for account change.",
  "inactive": "0",
  "frozen": "0"
}

Step 3: Create a new document (noteDocument) associated with the new Note.

Create a Document Resource to Associate with the Note - Example Code Snippet

Visit the Payrix Pro API Documentation for parameter descriptions and valid values.

Request URL & Header

CODE
POST /noteDocuments HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: api-test.payrix.com
APIKEY:{{private_api_key}}

Example Request Body

JSON
{
  "note": "t1_not_xxxxxxxxxxxxxxxxxx",
  "type": "png",
  "documentType": "voidCheck",
  "description": "Updating Existing Bank Account.",
  "name": "Voided Bank Check for ABC Company",
  "status": "created",
  inactive: "0",
  frozen: "0"
}

Although voidCheck is used in the example request body, any of the following documents can be used in this process:

  • voidCheck: A voided check for bank account verification

  • bankStatement: A bank statement

  • bankLetter: A bank letter for verification

Important!

Submitting the wrong documentType (for example, submitting a bank letter when voidCheck is selected) can cause significant delays in underwriting approval.

Example Response

JSON
{
  "id": "t1_ntd_xxxxxxxxxxxxxxxxxx",
  "created": "2024-08-18 13:22:51.2252",
  "modified": "2024-08-18 13:22:51.2252",
  "creator": "t1_log_xxxxxxxxxxxxxxxxxx",
  "modifier": "t1_log_xxxxxxxxxxxxxxxxxx",
  "note": "t1_not_xxxxxxxxxxxxxxxxxx",
  "type": "png",
  "documentType": "voidCheck",
  "name": "Voided Bank Check for ABC Company",
  "description": "Updating Existing Bank Account",
  "status": "created",
  "inactive": "0",
  "frozen": "0"
}
Step 4: Upload the document file to the associated new document (noteDocument).

Upload the Image or Document File Associated with the Entity’s Note - Example Code Snippet

Visit the Payrix Pro API Documentation for parameter descriptions and valid values.

Request URL & Header

CODE
POST /files/noteDocuments/{id} HTTP/1.1
Accept: application/json
Content-Type: multipart/form-data
Body: form-data
Host: api-test.payrix.com

Example Request Body (form-data)

CODE
name: Document Name
filename: <Selected File>

Example Request Body (JSON)

JSON
{
  "credential": "string",
  "type": "png",
  "integration": "PAYRIX",
  "direction": "upload",
  "status": "pending",
  "retries": 0,
  "name": "Voided Bank Check for ABC Company",
  "inactive": 0,
  "frozen": 0
}

Example Response

JSON
{
  "id": "t1_fil_xxxxxxxxxxxx",
  "created": "2023-10-25T19:10:44.278Z",
  "modified": "2023-10-25T19:10:44.278Z",
  "creator": "t1_log_xxxxxxxxxxxxx",
  "modifier": "t1_log_xxxxxxxxxxxxx",
  "credential": "string",
  "integration": "PAYRIX",
  "name": "Voided Bank Check for ABC Company",
  "file": "string",
  "type": "png",
  "status": "pending",
  "retries": 0,
  "direction": "upload",
  "inactive": 0,
  "frozen": 0
}

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.