# Update merchant's business and owner information

## Update Merchant Business and Owner Information

Updates the business and owner information for an existing merchant application. Covers customer service contact details, federal tax ID, business start date, legal and DBA addresses, and KYC details for up to four owners and two controlling officers.

### Endpoint

`POST /api/v1/merchant/parameters`

### Authentication

Basic HTTP Authentication required.

```
Authorization: Basic {base64(username:password)}
```

### When to use

Use this endpoint when business contact information, owner details, or address data needs to be corrected or updated after the initial merchant submission. Underwriters frequently request corrections to owner SSNs, date of birth, or address information.

> ⚠️ All required sub-fields of `parameters` must be provided whenever the `parameters` object is included — partial updates are not supported.

***

### Request Body

#### Top-level structure

| Field      | Type            | Required | Description                              |
| ---------- | --------------- | -------- | ---------------------------------------- |
| id         | integer (int32) | Yes      | Merchant profile ID to update (1–999999) |
| parameters | TsysParameters  | No       | Business and owner parameters to update  |

***

#### `parameters` (TsysParameters)

| Field                   | Type               | Required | Description                                                 |            |
| :---------------------- | :----------------- | :------- | :---------------------------------------------------------- | :--------- |
| customerServicePhoneNum | string             | Yes      | 10-digit phone, must not start with 1                       |            |
| federalTaxId            | string             | Yes      | 9-char EIN — digits or `*` for masking (`^\d{9}$` or \`^(\d | \*){9}$\`) |
| dateOfStartBusiness     | string (date-time) | Yes      | Business start date ISO 8601                                |            |
| merchantEmail           | string             | No       | Business contact email address                              |            |
| merchantWebsite         | string             | No       | Business website URL                                        |            |
| multipleLocations       | boolean            | No       | Whether merchant has multiple locations                     |            |
| numOfLocations          | integer            | No       | Number of locations if `multipleLocations` is true          |            |
| legalAddress            | AddressBase        | Yes      | Legal registered address                                    |            |
| dbaAddress              | AddressBase        | Yes      | DBA operating address                                       |            |
| primaryOwner            | Owner              | Yes      | Primary owner KYC details                                   |            |
| secondaryOwner          | SecondaryOwner     | No       | Second owner                                                |            |
| owner3                  | SecondaryOwner     | No       | Third owner                                                 |            |
| owner4                  | SecondaryOwner     | No       | Fourth owner                                                |            |
| controllingOfficer1     | ControllingOfficer | No       | Controlling officer 1                                       |            |
| controllingOfficer2     | ControllingOfficer | No       | Controlling officer 2                                       |            |

***

#### `AddressBase` (used for `legalAddress` and `dbaAddress`)

| Field      | Type          | Required | Description                                |
| ---------- | ------------- | -------- | ------------------------------------------ |
| name       | string        | Yes      | Business name at this address              |
| address    | string        | Yes      | Street address line 1                      |
| address2   | string        | No       | 🆕 Suite, unit, floor, or apartment number |
| postalCode | string        | Yes      | ZIP code                                   |
| city       | string        | Yes      | City                                       |
| state      | string (enum) | Yes      | Full US state name — see enum below        |
| phone      | string        | Yes      | Phone number, must not start with 1        |
| fax        | string        | No       | Fax number                                 |

**`state` enum:** `Alaska`, `Alabama`, `Arkansas`, `Arizona`, `California`, `Colorado`, `Connecticut`, `DistrictOfColumbia`, `Delaware`, `Florida`, `Georgia`, `Hawaii`, `Iowa`, `Idaho`, `Illinois`, `Indiana`, `Kansas`, `Kentucky`, `Louisiana`, `Massachusetts`, `Maryland`, `Maine`, `Michigan`, `Minnesota`, `Missouri`, `Mississippi`, `Montana`, `NorthCarolina`, `NorthDakota`, `Nebraska`, `NewHampshire`, `NewJersey`, `NewMexico`, `Nevada`, `NewYork`, `Ohio`, `Oklahoma`, `Oregon`, `Pennsylvania`, `PuertoRico`, `RhodeIsland`, `SouthCarolina`, `SouthDakota`, `Tennessee`, `Texas`, `Utah`, `Virginia`, `VirginIslands`, `Vermont`, `Washington`, `Wisconsin`, `WestVirginia`, `Wyoming`

***

#### `Owner` (used for `primaryOwner`) / `SecondaryOwner` (used for `secondaryOwner`, `owner3`, `owner4`)

Both schemas are identical in structure.

| Field            | Type               | Required | Description                                                                                                                        |
| ---------------- | ------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| firstName        | string             | Yes      | 2–25 letters only                                                                                                                  |
| lastName         | string             | Yes      | 2–25 letters only                                                                                                                  |
| middleName       | string             | No       | 2–25 letters only                                                                                                                  |
| dateOfBirth      | string (date-time) | Yes      | Date of birth ISO 8601                                                                                                             |
| ssn              | string             | Yes      | 9-digit SSN — no sequential or repeated patterns                                                                                   |
| address          | string             | Yes      | Street address, max 40 chars, alphanumeric only                                                                                    |
| city             | string             | Yes      | 2–25 chars                                                                                                                         |
| state            | string (enum)      | Yes      | Full US state name                                                                                                                 |
| zip              | string             | Yes      | `XXXXX` or `XXXXX-XXXX` format                                                                                                     |
| homePhone        | string             | Yes      | Must not start with 1                                                                                                              |
| title            | string (enum)      | Yes      | `President`, `VPresident`, `Owner`, `Partner`, `Manager`, `Treasurer`, `Secretary`, `ExecDirector`                                 |
| ownership        | integer            | Yes      | Ownership percentage 0–100                                                                                                         |
| email            | string             | Yes      | Max 60 chars                                                                                                                       |
| guarantor        | boolean            | No       | Whether owner is a personal guarantor                                                                                              |
| typeOfIssuedID   | string (enum)      | No       | `USPassport`, `PermanentRegistrationCard`, `DriversLicense`, `USMilitaryCard`, `USCostGuardMerchantMarinerCard`, `USCitizenIdCard` |
| idNumber         | string             | No       | Alphanumeric ID document number                                                                                                    |
| idExpirationDate | string (date-time) | No       | ID expiration date ISO 8601                                                                                                        |

***

#### `ControllingOfficer` (used for `controllingOfficer1` and `controllingOfficer2`)

| Field            | Type               | Required | Description                                                                                        |
| ---------------- | ------------------ | -------- | -------------------------------------------------------------------------------------------------- |
| firstName        | string             | Yes      | 2–25 letters only                                                                                  |
| lastName         | string             | Yes      | 2–25 letters only                                                                                  |
| middleName       | string             | No       | 2–25 letters only                                                                                  |
| dateOfBirth      | string (date-time) | Yes      | Date of birth ISO 8601                                                                             |
| ssn              | string             | Yes      | 9-digit SSN — no sequential or repeated patterns                                                   |
| title            | string (enum)      | Yes      | `President`, `VPresident`, `Owner`, `Partner`, `Manager`, `Treasurer`, `Secretary`, `ExecDirector` |
| address          | string             | Yes      | Max 40 chars, alphanumeric only                                                                    |
| city             | string             | Yes      | 2–25 chars                                                                                         |
| state            | string (enum)      | Yes      | Full US state name                                                                                 |
| zip              | string             | Yes      | ZIP code (`XXXXX` or `XXXXX-XXXX`)                                                                 |
| homePhone        | string             | Yes      | Must not start with 1                                                                              |
| email            | string             | No       | 🆕 Max 60 chars                                                                                    |
| guarantor        | boolean            | No       | Whether officer is a personal guarantor                                                            |
| typeOfIssuedID   | string (enum)      | No       | Same enum as Owner.typeOfIssuedID                                                                  |
| idNumber         | string             | No       | Alphanumeric ID document number                                                                    |
| idExpirationDate | string (date-time) | No       | ID expiration date ISO 8601                                                                        |

***

### Request Example

```json
{
  "id": 10482,
  "parameters": {
    "customerServicePhoneNum": "8005551234",
    "federalTaxId": "123456789",
    "dateOfStartBusiness": "2018-03-15T00:00:00Z",
    "merchantEmail": "owner@greentreecafe.com",
    "merchantWebsite": "https://greentreecafe.com",
    "multipleLocations": false,
    "legalAddress": {
      "name": "Green Tree Cafe LLC",
      "address": "450 Main St",
      "address2": "Suite 100",
      "postalCode": "30301",
      "city": "Atlanta",
      "state": "Georgia",
      "phone": "4045557890"
    },
    "dbaAddress": {
      "name": "Green Tree Cafe",
      "address": "450 Main St",
      "address2": "Suite 100",
      "postalCode": "30301",
      "city": "Atlanta",
      "state": "Georgia",
      "phone": "4045557890"
    },
    "primaryOwner": {
      "firstName": "Marcus",
      "lastName": "Jordan",
      "dateOfBirth": "1978-06-21T00:00:00Z",
      "ssn": "500123456",
      "address": "112 Peachtree Ln",
      "city": "Atlanta",
      "state": "Georgia",
      "zip": "30302",
      "homePhone": "4045559876",
      "title": "Owner",
      "ownership": 100,
      "email": "mjordan@greentreecafe.com",
      "guarantor": true,
      "typeOfIssuedID": "DriversLicense",
      "idNumber": "GA123456789",
      "idExpirationDate": "2028-06-21T00:00:00Z"
    },
    "controllingOfficer1": {
      "firstName": "Sarah",
      "lastName": "Jordan",
      "dateOfBirth": "1980-04-10T00:00:00Z",
      "ssn": "500987654",
      "title": "President",
      "address": "112 Peachtree Ln",
      "city": "Atlanta",
      "state": "Georgia",
      "zip": "30302",
      "homePhone": "4045559877",
      "email": "sjordan@greentreecafe.com"
    }
  }
}
```

***

### Response

**200 OK**

| Field             | Type    | Description                                                                                |
| ----------------- | ------- | ------------------------------------------------------------------------------------------ |
| data              | object  | Empty object on success                                                                    |
| status            | string  | HTTP status name, e.g. `OK`                                                                |
| error             | string  | Error message if failed, otherwise null                                                    |
| warning           | string  | Non-fatal warning if any                                                                   |
| validationResults | array   | Field-level validation errors — each has `memberNames` (array) and `errorMessage` (string) |
| requestId         | integer | Internal request tracking ID                                                               |

```json
{
  "data": {},
  "status": "OK",
  "error": null,
  "warning": null,
  "validationResults": [],
  "requestId": 71205
}
```

***

### Error Codes

| Code | When it happens                                                                                                    |
| ---- | ------------------------------------------------------------------------------------------------------------------ |
| 400  | `id` missing; required `parameters` sub-fields absent; SSN/phone/ZIP validation failed — check `validationResults` |
| 401  | Invalid or missing Basic Auth credentials                                                                          |
| 403  | No permission to update this merchant application                                                                  |
| 404  | No merchant application found with the given `id`                                                                  |
| 500  | Internal server error                                                                                              |

***

### Common Mistakes

* **Partial updates not supported** — all required fields within `parameters` must be present even when updating just one field (e.g. address).
* `customerServicePhoneNum` must be exactly 10 digits — no spaces, dashes, or parentheses, must not start with 1.
* `federalTaxId` must be exactly 9 characters — digits only or `*` for masking. No dashes (`47-1234567` is invalid).
* `ssn` must be 9 digits and cannot be sequential (`123456789`), repeated (`111111111`), or other blocked patterns.
* `firstName` and `lastName` must contain only letters — no spaces within names, no hyphens.
* `zip` must match `XXXXX` or `XXXXX-XXXX` — use hyphen format for 9-digit ZIPs.
* `state` must be the full enum value — `Georgia` not `GA` or `"Georgia"`.
* `address2` is optional and backward compatible — omitting it does not affect existing integrations.
* Controlling officer `email` is optional — omitting it will not clear a previously stored value unless you explicitly send `null`.
* All owners with 20%+ ownership must be listed in the appropriate owner slot.

***

### Related Endpoints

* [`GET /api/v1/merchant/parameters`](./boarding_gettsysparameters.md) — read current parameters before updating
* [`POST /api/v1/merchant/submit`](./boarding_submittsys.md) — initial merchant submission
* [`POST /api/v1/merchant/account`](./boarding_updatesalesandbusinessprofile.md) — update sales and business profile
* [`POST /api/v1/merchant/siteInspection`](./boarding_updatesiteinspection.md) — update site inspection details
* [`GET /api/v1/merchant/status`](./boarding_getstatus.md) — check application status

***

### Example

```bash
curl -X POST https://hq.staging.netevia.dev/api/v1/merchant/parameters \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 10482,
    "parameters": {
      "customerServicePhoneNum": "8005551234",
      "federalTaxId": "123456789",
      "dateOfStartBusiness": "2018-03-15T00:00:00Z",
      "legalAddress": {
        "name": "Green Tree Cafe LLC",
        "address": "450 Main St",
        "address2": "Suite 100",
        "postalCode": "30301",
        "city": "Atlanta",
        "state": "Georgia",
        "phone": "4045557890"
      },
      "dbaAddress": {
        "name": "Green Tree Cafe",
        "address": "450 Main St",
        "postalCode": "30301",
        "city": "Atlanta",
        "state": "Georgia",
        "phone": "4045557890"
      },
      "primaryOwner": {
        "firstName": "Marcus",
        "lastName": "Jordan",
        "dateOfBirth": "1978-06-21T00:00:00Z",
        "ssn": "500123456",
        "address": "112 Peachtree Ln",
        "city": "Atlanta",
        "state": "Georgia",
        "zip": "30302",
        "homePhone": "4045559876",
        "title": "Owner",
        "ownership": 100,
        "email": "mjordan@greentreecafe.com"
      }
    }
  }'
```

<br />

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "v1",
    "title": "Netevia HQ | API Documentation",
    "description": "Netevia HQ | API Documentation"
  },
  "paths": {
    "/api/v1/merchant/parameters": {
      "post": {
        "tags": [
          "Merchant applications/Merchants data management"
        ],
        "summary": "Update merchant's business and owner information",
        "operationId": "Boarding_UpdateTsysParameters",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTsysParameters"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTsysParameters"
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTsysParameters"
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTsysParameters"
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTsysParameters"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponse1_UpdateMerchantResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponse1_UpdateMerchantResponse"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponse1_UpdateMerchantResponse"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponse1_UpdateMerchantResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "Basic": []
    }
  ],
  "servers": [
    {
      "url": "https://hq.staging.netevia.dev"
    }
  ],
  "components": {
    "securitySchemes": {
      "Basic": {
        "type": "http",
        "description": "Basic HTTP Authentication",
        "scheme": "basic"
      }
    },
    "schemas": {
      "ValidationResult": {
        "type": "object",
        "properties": {
          "memberNames": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "readOnly": true
          },
          "errorMessage": {
            "type": "string"
          }
        }
      },
      "TsysParameters": {
        "required": [
          "customerServicePhoneNum",
          "federalTaxId",
          "dateOfStartBusiness",
          "legalAddress",
          "dbaAddress",
          "primaryOwner"
        ],
        "type": "object",
        "properties": {
          "customerServicePhoneNum": {
            "maxLength": 10,
            "minLength": 10,
            "pattern": "^[^1].*",
            "type": "string"
          },
          "federalTaxId": {
            "pattern": "^(\\d|\\*){9}$",
            "type": "string"
          },
          "dateOfStartBusiness": {
            "format": "date-time",
            "type": "string"
          },
          "merchantEmail": {
            "type": "string"
          },
          "merchantWebsite": {
            "pattern": "^((https?):\\/\\/)?(([wW]{3}\\.)?([a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,100})((\\/([\\w-]+\\/?)*)?)$",
            "type": "string"
          },
          "multipleLocations": {
            "type": "boolean"
          },
          "numOfLocations": {
            "format": "int32",
            "type": "integer"
          },
          "legalAddress": {
            "$ref": "#/components/schemas/AddressBase"
          },
          "dbaAddress": {
            "$ref": "#/components/schemas/AddressBase"
          },
          "primaryOwner": {
            "$ref": "#/components/schemas/Owner"
          },
          "secondaryOwner": {
            "$ref": "#/components/schemas/SecondaryOwner"
          },
          "owner3": {
            "$ref": "#/components/schemas/SecondaryOwner"
          },
          "owner4": {
            "$ref": "#/components/schemas/SecondaryOwner"
          },
          "controllingOfficer1": {
            "$ref": "#/components/schemas/ControllingOfficer"
          },
          "controllingOfficer2": {
            "$ref": "#/components/schemas/ControllingOfficer"
          }
        }
      },
      "AddressBase": {
        "required": [
          "name",
          "address",
          "postalCode",
          "city",
          "state",
          "phone"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "address": {
            "type": "string"
          },
          "address2": {
            "type": "string"
          },
          "postalCode": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "state": {
            "enum": [
              "Alaska",
              "Alabama",
              "Arkansas",
              "Arizona",
              "California",
              "Colorado",
              "Connecticut",
              "DistrictOfColumbia",
              "Delaware",
              "Florida",
              "Georgia",
              "Hawaii",
              "Iowa",
              "Idaho",
              "Illinois",
              "Indiana",
              "Kansas",
              "Kentucky",
              "Louisiana",
              "Massachusetts",
              "Maryland",
              "Maine",
              "Michigan",
              "Minnesota",
              "Missouri",
              "Mississippi",
              "Montana",
              "NorthCarolina",
              "NorthDakota",
              "Nebraska",
              "NewHampshire",
              "NewJersey",
              "NewMexico",
              "Nevada",
              "NewYork",
              "Ohio",
              "Oklahoma",
              "Oregon",
              "Pennsylvania",
              "PuertoRico",
              "RhodeIsland",
              "SouthCarolina",
              "SouthDakota",
              "Tennessee",
              "Texas",
              "Utah",
              "Virginia",
              "VirginIslands",
              "Vermont",
              "Washington",
              "Wisconsin",
              "WestVirginia",
              "Wyoming"
            ],
            "type": "string"
          },
          "phone": {
            "pattern": "^[^1].*",
            "type": "string"
          },
          "fax": {
            "pattern": "^[^1].*",
            "type": "string"
          }
        }
      },
      "Owner": {
        "required": [
          "firstName",
          "lastName",
          "dateOfBirth",
          "ssn",
          "address",
          "city",
          "state",
          "zip",
          "homePhone",
          "title",
          "ownership",
          "email"
        ],
        "type": "object",
        "properties": {
          "firstName": {
            "maxLength": 25,
            "minLength": 2,
            "pattern": "^\\s*[A-Za-z]+\\s*$",
            "type": "string"
          },
          "middleName": {
            "maxLength": 25,
            "minLength": 2,
            "pattern": "^\\s*[A-Za-z]+\\s*$",
            "type": "string"
          },
          "lastName": {
            "maxLength": 25,
            "minLength": 2,
            "pattern": "^\\s*[A-Za-z]+\\s*$",
            "type": "string"
          },
          "dateOfBirth": {
            "format": "date-time",
            "type": "string"
          },
          "ssn": {
            "pattern": "^(?!000000000|111111111|222222222|333333333|444444444|55555555|666666666|777777777|888888888|999999999|123456789|987654321|012345678|087654321)\\d{9}$",
            "type": "string"
          },
          "address": {
            "maxLength": 40,
            "minLength": 0,
            "pattern": "^[A-Za-z\\d\\s]+$",
            "type": "string"
          },
          "city": {
            "maxLength": 25,
            "minLength": 2,
            "type": "string"
          },
          "state": {
            "enum": [
              "Alaska",
              "Alabama",
              "Arkansas",
              "Arizona",
              "California",
              "Colorado",
              "Connecticut",
              "DistrictOfColumbia",
              "Delaware",
              "Florida",
              "Georgia",
              "Hawaii",
              "Iowa",
              "Idaho",
              "Illinois",
              "Indiana",
              "Kansas",
              "Kentucky",
              "Louisiana",
              "Massachusetts",
              "Maryland",
              "Maine",
              "Michigan",
              "Minnesota",
              "Missouri",
              "Mississippi",
              "Montana",
              "NorthCarolina",
              "NorthDakota",
              "Nebraska",
              "NewHampshire",
              "NewJersey",
              "NewMexico",
              "Nevada",
              "NewYork",
              "Ohio",
              "Oklahoma",
              "Oregon",
              "Pennsylvania",
              "PuertoRico",
              "RhodeIsland",
              "SouthCarolina",
              "SouthDakota",
              "Tennessee",
              "Texas",
              "Utah",
              "Virginia",
              "VirginIslands",
              "Vermont",
              "Washington",
              "Wisconsin",
              "WestVirginia",
              "Wyoming"
            ],
            "type": "string"
          },
          "zip": {
            "pattern": "^\\d{5}(-\\d{4})?$",
            "type": "string"
          },
          "homePhone": {
            "pattern": "^[^1].*",
            "type": "string"
          },
          "title": {
            "enum": [
              "President",
              "VPresident",
              "Owner",
              "Partner",
              "Manager",
              "Treasurer",
              "Secretary",
              "ExecDirector"
            ],
            "type": "string"
          },
          "ownership": {
            "format": "int32",
            "maximum": 100,
            "minimum": 0,
            "type": "integer"
          },
          "email": {
            "maxLength": 60,
            "minLength": 0,
            "type": "string"
          },
          "guarantor": {
            "type": "boolean"
          },
          "typeOfIssuedID": {
            "enum": [
              "USPassport",
              "PermanentRegistrationCard",
              "DriversLicense",
              "USMilitaryCard",
              "USCostGuardMerchantMarinerCard",
              "USCitizenIdCard"
            ],
            "type": "string"
          },
          "idNumber": {
            "pattern": "^[a-zA-Z0-9]+$",
            "type": "string"
          },
          "idExpirationDate": {
            "format": "date-time",
            "type": "string"
          }
        }
      },
      "SecondaryOwner": {
        "required": [
          "firstName",
          "lastName",
          "dateOfBirth",
          "ssn",
          "address",
          "city",
          "state",
          "zip",
          "homePhone",
          "title",
          "ownership",
          "email"
        ],
        "type": "object",
        "properties": {
          "firstName": {
            "maxLength": 25,
            "minLength": 2,
            "pattern": "^\\s*[A-Za-z]+\\s*$",
            "type": "string"
          },
          "middleName": {
            "maxLength": 25,
            "minLength": 2,
            "pattern": "^\\s*[A-Za-z]+\\s*$",
            "type": "string"
          },
          "lastName": {
            "maxLength": 25,
            "minLength": 2,
            "pattern": "^\\s*[A-Za-z]+\\s*$",
            "type": "string"
          },
          "dateOfBirth": {
            "format": "date-time",
            "type": "string"
          },
          "ssn": {
            "pattern": "^(?!000000000|111111111|222222222|333333333|444444444|55555555|666666666|777777777|888888888|999999999|123456789|987654321|012345678|087654321)\\d{9}$",
            "type": "string"
          },
          "address": {
            "maxLength": 40,
            "minLength": 0,
            "pattern": "^[A-Za-z\\d\\s]+$",
            "type": "string"
          },
          "city": {
            "maxLength": 25,
            "minLength": 2,
            "type": "string"
          },
          "state": {
            "enum": [
              "Alaska",
              "Alabama",
              "Arkansas",
              "Arizona",
              "California",
              "Colorado",
              "Connecticut",
              "DistrictOfColumbia",
              "Delaware",
              "Florida",
              "Georgia",
              "Hawaii",
              "Iowa",
              "Idaho",
              "Illinois",
              "Indiana",
              "Kansas",
              "Kentucky",
              "Louisiana",
              "Massachusetts",
              "Maryland",
              "Maine",
              "Michigan",
              "Minnesota",
              "Missouri",
              "Mississippi",
              "Montana",
              "NorthCarolina",
              "NorthDakota",
              "Nebraska",
              "NewHampshire",
              "NewJersey",
              "NewMexico",
              "Nevada",
              "NewYork",
              "Ohio",
              "Oklahoma",
              "Oregon",
              "Pennsylvania",
              "PuertoRico",
              "RhodeIsland",
              "SouthCarolina",
              "SouthDakota",
              "Tennessee",
              "Texas",
              "Utah",
              "Virginia",
              "VirginIslands",
              "Vermont",
              "Washington",
              "Wisconsin",
              "WestVirginia",
              "Wyoming"
            ],
            "type": "string"
          },
          "zip": {
            "pattern": "^\\d{5}(-\\d{4})?$",
            "type": "string"
          },
          "homePhone": {
            "pattern": "^[^1].*",
            "type": "string"
          },
          "title": {
            "enum": [
              "President",
              "VPresident",
              "Owner",
              "Partner",
              "Manager",
              "Treasurer",
              "Secretary",
              "ExecDirector"
            ],
            "type": "string"
          },
          "ownership": {
            "format": "int32",
            "maximum": 100,
            "minimum": 0,
            "type": "integer"
          },
          "email": {
            "maxLength": 60,
            "minLength": 0,
            "type": "string"
          },
          "guarantor": {
            "type": "boolean"
          },
          "typeOfIssuedID": {
            "enum": [
              "USPassport",
              "PermanentRegistrationCard",
              "DriversLicense",
              "USMilitaryCard",
              "USCostGuardMerchantMarinerCard",
              "USCitizenIdCard"
            ],
            "type": "string"
          },
          "idNumber": {
            "pattern": "^[a-zA-Z0-9]+$",
            "type": "string"
          },
          "idExpirationDate": {
            "format": "date-time",
            "type": "string"
          }
        }
      },
      "ControllingOfficer": {
        "required": [
          "dateOfBirth",
          "ssn",
          "firstName",
          "lastName",
          "title",
          "address",
          "zip",
          "city",
          "state",
          "homePhone"
        ],
        "type": "object",
        "properties": {
          "dateOfBirth": {
            "format": "date-time",
            "type": "string"
          },
          "ssn": {
            "pattern": "^(?!000000000|111111111|222222222|333333333|444444444|55555555|666666666|777777777|888888888|999999999|123456789|987654321|012345678|087654321)\\d{9}$",
            "type": "string"
          },
          "firstName": {
            "maxLength": 25,
            "minLength": 2,
            "pattern": "^\\s*[A-Za-z]+\\s*$",
            "type": "string"
          },
          "middleName": {
            "maxLength": 25,
            "minLength": 2,
            "pattern": "^\\s*[A-Za-z]+\\s*$",
            "type": "string"
          },
          "lastName": {
            "maxLength": 25,
            "minLength": 2,
            "pattern": "^\\s*[A-Za-z]+\\s*$",
            "type": "string"
          },
          "title": {
            "enum": [
              "President",
              "VPresident",
              "Owner",
              "Partner",
              "Manager",
              "Treasurer",
              "Secretary",
              "ExecDirector"
            ],
            "type": "string"
          },
          "address": {
            "maxLength": 40,
            "minLength": 0,
            "pattern": "^[A-Za-z\\d\\s]+$",
            "type": "string"
          },
          "zip": {
            "pattern": "^\\d{5}(-\\d{4})?$",
            "type": "string"
          },
          "city": {
            "maxLength": 25,
            "minLength": 2,
            "type": "string"
          },
          "state": {
            "enum": [
              "Alaska",
              "Alabama",
              "Arkansas",
              "Arizona",
              "California",
              "Colorado",
              "Connecticut",
              "DistrictOfColumbia",
              "Delaware",
              "Florida",
              "Georgia",
              "Hawaii",
              "Iowa",
              "Idaho",
              "Illinois",
              "Indiana",
              "Kansas",
              "Kentucky",
              "Louisiana",
              "Massachusetts",
              "Maryland",
              "Maine",
              "Michigan",
              "Minnesota",
              "Missouri",
              "Mississippi",
              "Montana",
              "NorthCarolina",
              "NorthDakota",
              "Nebraska",
              "NewHampshire",
              "NewJersey",
              "NewMexico",
              "Nevada",
              "NewYork",
              "Ohio",
              "Oklahoma",
              "Oregon",
              "Pennsylvania",
              "PuertoRico",
              "RhodeIsland",
              "SouthCarolina",
              "SouthDakota",
              "Tennessee",
              "Texas",
              "Utah",
              "Virginia",
              "VirginIslands",
              "Vermont",
              "Washington",
              "Wisconsin",
              "WestVirginia",
              "Wyoming"
            ],
            "type": "string"
          },
          "homePhone": {
            "pattern": "^[^1].*",
            "type": "string"
          },
          "typeOfIssuedID": {
            "enum": [
              "USPassport",
              "PermanentRegistrationCard",
              "DriversLicense",
              "USMilitaryCard",
              "USCostGuardMerchantMarinerCard",
              "USCitizenIdCard"
            ],
            "type": "string"
          },
          "idNumber": {
            "pattern": "^[a-zA-Z0-9]+$",
            "type": "string"
          },
          "idExpirationDate": {
            "format": "date-time",
            "type": "string"
          },
          "guarantor": {
            "type": "boolean"
          },
          "email": {
            "maxLength": 60,
            "minLength": 0,
            "type": "string"
          }
        }
      },
      "ApiResponse1_UpdateMerchantResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/UpdateMerchantResponse"
          },
          "status": {
            "enum": [
              "Continue",
              "SwitchingProtocols",
              "OK",
              "Created",
              "Accepted",
              "NonAuthoritativeInformation",
              "NoContent",
              "ResetContent",
              "PartialContent",
              "MultipleChoices",
              "Ambiguous",
              "MovedPermanently",
              "Moved",
              "Found",
              "Redirect",
              "SeeOther",
              "RedirectMethod",
              "NotModified",
              "UseProxy",
              "Unused",
              "TemporaryRedirect",
              "RedirectKeepVerb",
              "BadRequest",
              "Unauthorized",
              "PaymentRequired",
              "Forbidden",
              "NotFound",
              "MethodNotAllowed",
              "NotAcceptable",
              "ProxyAuthenticationRequired",
              "RequestTimeout",
              "Conflict",
              "Gone",
              "LengthRequired",
              "PreconditionFailed",
              "RequestEntityTooLarge",
              "RequestUriTooLong",
              "UnsupportedMediaType",
              "RequestedRangeNotSatisfiable",
              "ExpectationFailed",
              "UpgradeRequired",
              "InternalServerError",
              "NotImplemented",
              "BadGateway",
              "ServiceUnavailable",
              "GatewayTimeout",
              "HttpVersionNotSupported"
            ],
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "warning": {
            "type": "string"
          },
          "validationResults": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidationResult"
            }
          },
          "requestId": {
            "format": "int32",
            "type": "integer"
          }
        }
      },
      "UpdateMerchantResponse": {
        "type": "object",
        "properties": {}
      },
      "UpdateTsysParameters": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "parameters": {
            "$ref": "#/components/schemas/TsysParameters"
          },
          "id": {
            "format": "int32",
            "maximum": 999999,
            "minimum": 1,
            "type": "integer"
          }
        }
      }
    }
  }
}
```