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 that who are already boarded or integrating new bank accounts in the future.
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 are required to must have an active U.S.-based bank account on file. A bank account serves two purposes for an entity:
Account for Deposits - Arequired bank account on file to receive deposits from Available Balance funds.
Account for Debits - A required bank account on file 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.
...
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 as the result of due to a typo or invalid information.
...
If an entity manually submits their its bank account, they are required to submit documentation to Platform Risk for account validation.
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 . See using the steps provided below:.
...
title | Click here to see API code examples for submitting supporting bank account documents. |
---|
Submit Bank Account Supporting Documents using the API
URL
Code Block |
---|
POST https://api.payrix.com/noteDocuments |
Header
Code Block |
---|
Content-Type:application/json
APIKEY:{{private_api_key}} |
Request Body
Code Block | ||
---|---|---|
| ||
{
"note": "{{Note_ID}}",
"type": "PNG",
"documentType": "voidCheck",
"description": "Description of file"
} |
Example Response
Code Block | ||
---|---|---|
| ||
{
"response": {
"data": [
{
"id": "{{Document_ID}}",
"created": "2024-08-18 13:22:51.2252",
"modified": "2024-08-18 13:22:51.2252",
"creator": "{{createdByUserId}}",
"modifier": "{{createdByUserId}}",
"note": "{{Note_ID}}",
"custom": null,
"type": "PNG",
"documentType": "voidCheck",
"name": null,
"description": "Description of File",
"status": "created",
"inactive": 0,
"frozen": 0
}
],
"details": {
"requestId": 1
},
"errors": []
}
} |
Qualifying Bank Account Supporting Documentation is:
A Void Check,
A Bank Letter, or;
A Bank Statement.
Note |
---|
New Bank Account/Update Approval PeriodFor new bank accounts or existing bank accounts having account or routing numbers updated, manual review of the supporting document(s) is required for approval and can take up to 5 business days. |
Warning |
---|
Payments Interrupted During Approval PeriodDuring 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.
|
Info |
---|
Minor Updates to Existing Bank AccountsFor existing bank accounts, supporting documents are only required if the routing or account number fields are being updated. |
Link a Bank Account with Plaid
With Plaid enabled Merchants or Referrers will be prompted to go through the bank account linking process as they sign up.
Warning |
---|
Tip |
Qualifying Bank Account Supporting Documentation is:
|
Info |
---|
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.
Note |
---|
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. |
Warning |
---|
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.
|
...
Link a Bank Account with Plaid
With Plaid enabled Merchants or Referrers will be prompted to go through the bank account linking process as they sign up.
Warning |
---|
This process will require 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. |
...
Expand | ||
---|---|---|
| ||
Step 1: Navigate to the Merchants page 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 ADD NEW ACCOUNT button in the upper right-hand corner. Step 5: Click the LINK ACCOUNT button in the lightbox and select the type of usage: Billing, Deposits, or All. Step 6: Click the LINK NEW ACCOUNT button in the lightbox to reveal the Plaid integration lightbox. Step 7: Complete each Plaid prompt:
|
...
If an entity’s bank is not eligible for use with Plaid, or if they wish to skip the Plaid process, they can also manually add a new bank account.
There are two methods available to manually add 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.
...
Expand | ||||
---|---|---|---|---|
| ||||
To manually add a new bank account in the portal, follow the steps below: Step 1: Navigate to the Merchants page within the Management category. Step 2: Click on the desired Merchant to bring up their Merchant Profile. Step 3: Click the Banking tab on the left. Step 4: Click the ADD NEW ACCOUNT button in the upper right-hand corner. Step 5: Click the ADD ACCOUNT MANUALLY button in the lightbox and view the prompt below:
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
Step 8: Upload one of the qualifying support documents into the Upload and attach filesAttach Files field. Step 9: Click the ADD button to complete the process.
|
Expand | |||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||
“Adding a New Bank Account”fieldsForm Fields &descriptionsDescriptions
|
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.
Info |
---|
You can find the full description of this resource in our API Reference. |
Expand | ||
---|---|---|
| ||
Manually Add a New Bank Account |
...
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.
Info |
---|
You can find the full description of this resource in our API Reference. |
Expand | |||||
---|---|---|---|---|---|
| |||||
Adding a new Bank Account - Example Code SnippetURL
Header
Example Request Body Code Block | | ||||
|
Code Block |
---|
POST /accounts HTTP/1.1
Accept: application/json
Host: api-test.payrix.com
APIKEY:{{private_api_key}} |
Example Request Body
Code Block | ||
---|---|---|
| ||
{
"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 | ||
---|---|---|
| ||
{ "account": { "id": "t1_pmt_xxxxxxxxxxxxxxxxx", "method": "10", "number": "{{$randomBankAccount}}1234567890123456", "routing": "{{Routing_Number_Sample}}"123456789", } } |
Example Response
Code Block | ||
---|---|---|
| ||
{"bin": "123456789", "responsepayment": {null, "datalastChecked": [ null, {"last4": "1111" }, "id": "t1_act_xxxxxxxxxxxxxxxxx", "accountcreated": { "2023-08-18 15:37:56.9284", "modified": "2024-08-18 15:37:56.9284", "idcreator": "t1_pmtlog_64dfc894cc34c311054a9e7xxxxxxxxxxxxxxx", "modifier": "t1_log_xxxxxxxxxxxxxxxx", "entity": "t1_ent_xxxxxxxxxxxxxxxxx", "methodtoken": "8ab1234cd5ef67g89012h34567a8b9c01", "name": "Bank Account Non-Primary", "description": "", "numberprimary": "0", "status": 0, "currency": "USD", "inactive": 0, "routingfrozen": "021000021"0, "expiration": null, "type": "all", "binreserved": "122000661"0, "checkStage": null } |
Expand | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
Create a Note Resource to Associate with an Entity and Documents - Example Code SnippetVisit our API Documentation for parameter descriptions and valid values. Request URL & Header
Example Request Body
Example Response
|
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
Create a Document Resource to Associate with the Note - Example Code SnippetVisit our API Documentation for parameter descriptions and valid values. Request URL & Header
Example Request Body
| |||||||
Expand | |||||||
| |||||||
“Add Bank Account” API Request Body - Fields & Descriptions | |||||||
Field | Required | Description | |||||
method | Required | Indicate the bank account type. Valid Values:
| |||||
routing | Required | Enter the 9-digit routing number associated with this bank account. | |||||
number | Required | Enter the account number associated with this bank account. | |||||
primary | Required | Is this the Merchant’s primary bank account? Valid Values:
| |||||
type | Required | Is this bank account for deposits, debits, or both (all). Valid Values:
| name | Optional | Give the bank account a custom name to differentiate it from other bank accounts on file.
"0"
} |
Info |
---|
|
Note |
---|
Warning: Submitting the wrong |
Example Response
Code Block | ||
---|---|---|
| ||
{
"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"
} |
Expand | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
Upload the Image or Document File Associated with the Entity’s Note - Example Code SnippetVisit our API Documentation for parameter descriptions and valid values. Request URL & Header
Example Request Body (form-data)
Example Request Body (JSON)
Example Response
|