Skip to main content
Skip table of contents

Updating a Bank Account

There are scenarios in which you may 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 will walk 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 Referrer-level users.

Bank Account Types and Requirements

All Merchants or Referrers 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 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.

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, & ownership and prevents funds from being sent to an incorrect bank account due to a typo or invalid information.

To perform the validation, the Platform uses Plaid to allow Merchants or Referrers to link their bank account(s) for instant validation using a Portal lightbox to securely log in to their bank for integration.

Manual Bank Account Validation - Supporting Documents

If an entity manually submits its bank account information, they are required to submit documentation to Platform Risk for account validation. See Steps 2-4 of the Manually Update with the API

Qualifying Bank Account Supporting Documentation is:

  • A Void Check,

  • A Bank Letter, or;

  • A Bank Statement.

For existing bank accounts, supporting documents are only required if the routing or account number fields are being updated. Changes to account types do not require supporting documentation.

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.

Warning: For existing bank accounts having account or routing numbers updated, a manual review of the supporting document(s) is required for approval and can take up to 5 business days.

Critical Warning: During the 5-day manual review and approval period, all payments processed will still be funded to your Portal account’s available balance and will be ready for immediate withdrawal to your bank account, once validated.

  • Enhancements to fund a previously approved account while you wait for a new account to be approved, coming soon.


Manually Update in the Portal

The Portal uses the Banking tab within the Merchant or Referrer Profile to update or add new bank account information to a specific Entity. In instances where an entity’s banking institution does not currently integrate with Plaid, or the Entity would like to manually add the account, this option is useful.

Click here to see Portal steps for manually updating an existing bank account.

To manually update an existing bank account in the Portal, follow the steps below:

Step 1: Navigate to the Merchants or Referrers page within the Management category.

Step 2: Click on the desired Merchant to bring up their Merchant Profile or Referrer Profile.

Step 3: Click the Banking tab on the left.

Step 4: Click the edit icon button in the upper right-hand corner.

Step 5: Click the ADD ACCOUNT MANUALLY button in the lightbox and view the prompt below:

Adding a new bank account will take up to 5 business to verify, you can continue to use your current bank account until your new account is confirmed

You will be required to upload a void check, bank statement, or bank letter to verify your account, Thank you for helping to keep your account safe.

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

Step 7: Enter the Type of bank account, Routing & Account Number, and Usage Options

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

Step 8: Upload one of the qualifying support documents into the Upload and Attach Files field.

Step 9: Click the ADD button to complete the process.

Note: You will not be able to use this manually added account for up to 5 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}

Step 1 - Update existing bank account information.

Updating an existing Bank Account - Example Code Snippet

Visit our API Documentation for parameter descriptions and valid values.

Request URL & Header

CODE
PUT /accounts/{id} 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": "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
}
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 our 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 our 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"
}

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.

Warning: Submitting the wrong documentType (i.e. submitting a bank letter when voidCheck is selected) may 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 our 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.