Updating a Bank Account

Updated
  • Updated on Jun 13, 2025
  • Published on May 13, 2025
  • 6 minute(s) read
Prev Next

There are scenarios in which you might want to update your existing account on the Platform, as opposed to adding a new bank account. This could be the result of fraudulent activity on your account where your bank provides you with a new account and/or routing number. This guide walks you through the update and validation process required to update the information for your existing bank account.

Note

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

Bank Account Types and Requirements

All Merchants or Partners boarded to the Platform must have an active U.S.-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 Partners 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.

Bank Account for Deposits

All payouts (disbursements) are processed to your primary bank account. If you want to add or update a bank account that’s designated for receiving payouts, then you must update your primary bank account with the new information.

Note

If you previously added your bank account for receiving disbursements as a secondary bank account, then you must:

  1. Disable your secondary bank account by replacing the account number with all zeros.

  2. Update your primary bank account with the correct routing number and account number for processing disbursements.

Bank Account Validation

As a Payment Facilitator, the 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.

Validation Through Plaid

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

Manual Validation with Supporting Documentation

If an entity manually submits their bank account information, they must submit supporting documentation for account validation by the Risk Team. For existing bank accounts, supporting documents are required only if the routing or account number fields are being updated. Changes to account types do not require supporting documentation.

The following documents are acceptable for validating bank accounts:

Qualifying Bank Account Supporting Documentation:

  • 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 manually update an account in the portal or using the API.

Important!

When updating account or routing numbers for existing or additional bank accounts, a manual review of the supporting documents is needed for approval and can take up to five business days.

During the five-day review and approval period for updating or adding another bank account, all processed payments are funded to your Payrix Pro account’s balance. Funds are ready for immediate withdrawal to your new or updated primary bank account after the account is validated.

Manually Update in the Portal

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

To manually update an existing bank account in the portal:

  1. From the Dashboard, go to your Profile page or the Merchants page to access a Merchant’s Profile page.

    Note

    Go to the Merchant Profile by selecting a Merchant from the Merchants page.

  2. Click the Banking tab on the left.

  3. Click the edit icon button in the upper-right corner.

  4. Click ADD ACCOUNT MANUALLY view the prompt that’s displayed.

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

  6. Enter the Type of bank account, Routing & Account Number, and Usage Options

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

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

  8. Click ADD to complete the process.

Important!

You will not be able to use this manually added account for up to five business days from update or creation.

Manually Update with the API

See the multi-step process below to update an existing bank account’s information and upload supporting documentation:

  1. Update the existing information for the bank account: PUT /accounts/{id}

  2. Upload supporting documentation for the change:

    1. Create the new Note resource: POST /notes

    2. Create a Document resource to associate with the upload: POST /noteDocuments

    3. Upload the document or image file: POST /files/noteDocuments/{id}

Update an Existing Bank Account: Example Code Snippet

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

Request URL & Header

PUT /accounts/{id} HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: api-test.payrix.com
APIKEY:{{private_api_key}}

Example Request Body

{
    "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

{
    "account": {
        "id": "t1_pmt_xxxxxxxxxxxxxxxxx",
        "method": "8",
        "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": "ac1234cc5ae67b89101a11213d1a4e15",
    "name": "Bank Account Non-Primary",
    "description": "",
    "primary": "0",
    "status": 0,
    "currency": "USD",
    "inactive": 0,
    "frozen": 0,
    "expiration": null,
    "type": "all",
    "reserved": 0,
    "checkStage": null
}

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

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

Example Request Body

{
  "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

{
  "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"
}

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

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

Example Request Body

{
  "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"
}

voidCheck is used in the example above, but 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

{
  "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"
}

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

POST /files/noteDocuments/{id} HTTP/1.1
Accept: application/json
Content-Type: multipart/form-data
Body: form-data
Host: api-test.payrix.com
name=Voided Bank Check
filename={filepath}
json={JSON-request}

Example Request Body (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

{
  "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 Pro",
  "name": "Voided Bank Check for ABC Company",
  "file": "string",
  "type": "png",
  "status": "pending",
  "retries": 0,
  "direction": "upload",
  "inactive": 0,
  "frozen": 0
}

Related articles