Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

All Merchants or Referrers processing on the Platform are required to must have at least one U.S. 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 will guide you through the process of adding additional bank accounts for Merchants or Referrers who are already boarded or integrating new bank accounts in the future.

...

  • Account for Deposits - Arequired bank account to receive deposits from Available Balance funds.

  • Account for Debits - A required bank account to be debited to cover Negative Balances 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.

...

When entering information in the Portal for a new bank account manually, like account and routing numbers, a file upload window at the bottom of the form requires a document file to be uploaded before the form can be submitted. This can also be achieved using the API using the steps provided below.\

Tip

Qualifying Bank Account Supporting Documentation is:

  • A Void Check,

  • A Bank Letter, or;

  • A Bank Statement.

...

Expand
titleClick here to view all fields and descriptions for the Add Bank Account form.

“Adding a New Bank Account”

fields

Form Fields &

descriptions

Descriptions

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

Info

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 utilized 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

Use this field to give the bank account a custom description if desired.

...

Expand
titleStep 1 - Add new account information.

Manually Add a New Bank Account - Example Code Snippet

Visit our API Documentation for parameter descriptions and valid values.

Request URL & Header

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

Example Request Body

Code Block
languagejson
{
    "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

Code Block
languagejson
{
    "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": "ac1234cc5ae67b89101a11213d1a4e15ab1234cd5ef67g89012h34567a8b9c01",
    "name": "Bank Account Non-Primary",
    "description": "",
    "primary": "0",
    "status": 0,
    "currency": "USD",
    "inactive": 0,
    "frozen": 0,
    "expiration": null,
    "type": "all",
    "reserved": 0,
    "checkStage": null
}

...