Class BankRequest
A Bank Request is used to update account information for an existing merchant, including Location Name, Account Number, Routing Number and Account Type.
note
The following fields are optional for 1099K reporting: Legal Name, DBA Name, Federal Tax ID, Address, City, State or Region, Postal Code. If any information is provided in the listed fields and the merchant has Location ID Level Boarding, then information must be provided for all 1099K fields.
Properties
| Field/Tag Name | Value | Required | Notes |
|---|---|---|---|
| custServProviderId | Y | Partner Id | |
| request_email | Y | Registered at Jack Henry; email format | |
| customer_name | Y | Merchant Name; alphanumeric (50) | |
| entity_id | Y | Merchant Id | |
| location_id | Y | Alphanumeric: Unique ID | |
| location_name | Y | Unique Location Name | |
| routing_number | Y | 9-digit ABA Routing & Transit number | |
| account_type | Checking, Savings, G/L | Y | |
| account_number | Y | Numeric: Merchants bank account number | |
| merchant_first_name | N | IF any merchant notification field is populated, all 4 must be populated | |
| merchant_last_name | N | IF any merchant notification field is populated, all 4 must be populated | |
| merchant_email | N | IF any merchant notification field is populated, all 4 must be populated | |
| merchant_phone | N | IF any merchant notification field is populated, all 4 must be populated | |
| legal_name | N | IF any 1099K field is populated, all must be populated | |
| dba_name | N | IF any 1099K field is populated, all must be populated | |
| federal_tax_id | N | ######### IF any 1099K field is populated, all must be populated | |
| address_1 | N | IF any 1099K field is populated, all must be populated | |
| address_2 | N | ||
| city | N | IF any 1099K field is populated, all must be populated | |
| state_or_region | N | USPS state abbreviations for US and Canada. Format is XX. IF any 1099K field is populated, all must be populated | |
| postal_code | N | ##### or #####-####; IF any 1099K field is populated, all must be populated | |
| subject | N | Text(255) | |
| description | N | Text(long) | |
| case_reason | Application Special Circumstances, Update Bank Account Information, Update Business Information | N | This is an optional field to explain the reason. |
Example BankRequest
Input Method: XML
<xml>
<custServProviderId>######</custServProviderId>
<entity_id>######</entity_id>
<customer_name>Sample Test</customer_name>
<request_email>none@example.com</request_email>
<case_reason>I have a new bank account</case_reason>
<location_id>########</location_id>
<location_name>Test Location</location_name>
<merchant_first_name></merchant_first_name>
<merchant_last_name></merchant_last_name>
<merchant_email></merchant_email>
<merchant_phone></merchant_phone>
<routing_number>#########</routing_number>
<account_type>savings</account_type>
<account_number>#####</account_number>
<legal_name></legal_name>
<dba_name></dba_name>
<federal_tax_id></federal_tax_id>
<address_1></address_1>
<address_2></address_2>
<city></city>
<state_or_region></state_or_region>
<postal_code></postal_code>
<case_reason></case_reason>
<subject></subject>
<description></description>
</xml>
Input Method: JSON
{
"custServProviderId": "######",
"entity_id": "######",
"customer_name": "Sample Test",
"request_email": "none@example.com",
"location_id": "#######",
"location_name": "Test Location",
"routing_number": "#########",
"account_type": "checking",
"account_number": "#####",
"merchant_first_name": "",
"merchant_last_name": "",
"merchant_email": "",
"merchant_phone": "",
"legal_name": "",
"dba_name": "",
"federal_tax_id": "",
"address_1": "",
"address_2": "",
"city": "",
"state_or_region": "",
"postal_code": "",
"case_reason": "",
"subject": "",
"description": ""
}