# Code and Formats
source: https://developer.mastercard.com/match/documentation/code-and-formats/index.md
## Errors {#errors}
If a transaction can't be processed, an error will occur. The errors can be for system, service or even network issues.
**Why would I need to use this resource?**
This resource is provided to you in the event the transaction can't be completed. The error can be for a specific service format issue, network connection or overall message format issue.
#### Response Values {#response-values}
**Source**
**Description:** This is the unique identifier that attempts to define the field in error when available. If a specific field can't be identified, System will be returned.
**Example:** If an error is produced because of required data it would be presented with the field missing data.
* Request.PayloadSecurity.Credential
* addMerchantRequest.merchant
\*\*ReasonCode\*\*
\*\*Description:\*\* This will identify the reason for the error.
\*\*Example:\*\*
* INVALID_INPUT_VALUE
* SECURITY_CREDENTIAL_MISSING
* SECURITY_CREDENTIAL_UNAUTHORIZED
* VOLUME_THRESHOLD_EXCEEDED
\*\*Description\*\*
\*\*Description:\*\* This is the text description of the error. This is optional and will only be displayed if more information is available than is stored in the data identifier and reason code.
\*\*Example:\*\*
* Merchant Principals exceed length 5
* The system is experiencing heavy traffic volume, please try again later
* Maximum requests exceeded for the current time window
\*\*Recoverable\*\*
\*\*Description:\*\* This is a true/false presentation to explain if the transaction was submitted again would it be successful or not.
\*\*Example:\*\* True or False
\*\*Sample Response\*\* \`\`\` { "Errors": { "Error": \[ { "Source": "Gateway", "ReasonCode": "INVALID_INPUT_FORMAT", "Description": "Payload too large. Limit: KB", "Recoverable": false, "Details": null } \] } } \`\`\`
### AUTH Error Code: {#auth-error-codebr}
| Sr.No. | Description | HTTP Status Code | AUTH RESPONSE CODE |
|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|-----------------------------------|
| 1 | The Authorization header is missing from the request or OAuth parameters are missing from the header. Check the Authorization Header. | 400 | INVALID_OAUTH_SBS |
| 2 | The value for oauth_consumer_key doesn't conform to the length/format requirements (97-character length, with an exclamation mark in the middle). | 400 | INVALID_OAUTH_CONSUMER_KEY |
| 3 | The value for oauth_consumer_key doesn't match an existing key or doesn't have access to the requested API. | 400 | INVALID_CLIENT_ID, INVALID_KEY_ID |
| 4 | The value for oauth_signature_method is invalid or not supported. | 400 | INVALID_OAUTH_SIGNATURE_METHOD |
| 5 | The value for oauth_timestamp was rejected. Check your clock is accurate . See below: **oauth_nonce and oauth_timestamp.** The OAuth nonce is a random string, uniquely generated for each request and also unique within a given time window. The request timestamp is a positive integer representing the number of seconds since 1970. It must match the current time. In this example, 1558370962 is equivalent to 05/20/2019 @ 4:49pm (UTC). The timestamp and nonce pair must be unique, or the request will be treated as a replay attack. | 403 | INVALID_OAUTH_TIMESTAMP |
| 6 | The value of oauth_nonce was already used. Check you actually send a different nonce with each new request and that your system is generating enough entropy. See above: **oauth_nonce and oauth_timestamp.** | 403 | OAUTH_NONCE_USED |
| 7 | The value of oauth_body_hash is incorrect. You can check: 1. The digest algorithm used for computing the oauth_body_hash value matches the one used in oauth_signature_method 2. There is no network proxy or equipment updating the request body after the request is sent 3. oauth_body_hash contains the digest of an empty string when the request does not have an entity-body 4. In case the service requires encryption, make sure the payload is encrypted before the request is signed. | 400 | INVALID_BODY_HASH |
| 8 | The oauth_signature value can't be verified (wrong signing key, wrong signing base string, ...). | 401 | AUTHENTICATION_FAILED |
| 9 | Renew your signing key or create a new one. | 403 | INVALID_KEY |
### Gateway Error Codes: {#gateway-error-codesbr}
For further information about Gateway Errors response codes and possible resolutions, see [Gateway Error Codes](https://developer.mastercard.com/platform/documentation/security-and-authentication/gateway-error-codes)
### MATCH API Server-side Error Code: {#match-api-server-side-error-code-br}
Note: The term Principal # refers to the primary individuals associated with the merchant.
* Principal 1 through Principal 5 are placeholders that represent up to five different principals linked to the merchant profile.
* Each error code mentioning Principal # can apply to any of these individuals (e.g., Principal 1, Principal 2, ... Principal 5).
#### TerminationInquiryRequest {#terminationinquiryrequest}
| HTTP Status CODE | ERROR MESSAGE | MATCH API RESPONSE CODE |
|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------|
| 400 | Merchant Country is required | MATCH-400-1001 |
| 400 | Merchant Principal # Country is required | MATCH-400-1001 |
| 400 | Merchant City is required | MATCH-400-1002 |
| 400 | Merchant Principal # City is required | MATCH-400-1002 |
| 400 | Merchant Name is required | MATCH-400-1003 |
| 400 | Merchant Address Country Subdivision is required for CANADA, UNITED STATES countries | MATCH-400-1004 |
| 400 | Merchant Principal # Address Country Subdivision is required for CANADA, UNITED STATES countries | MATCH-400-1004 |
| 400 | Merchant Postal Code is required for CANADA, UNITED STATES countries | MATCH-400-1005 |
| 400 | Merchant Principal # Postal Code is required for CANADA, UNITED STATES countries | MATCH-400-1005 |
| 400 | Merchant Principal # FirstName is required | MATCH-400-1006 |
| 400 | Merchant Principal # LastName is required | MATCH-400-1007 |
| 400 | Merchant Address line1 is required | MATCH-400-1008 |
| 400 | Merchant Principal # Address line1 is required | MATCH-400-1008 |
| 400 | Merchant Business Phone Number is required | MATCH-400-1009 |
| 400 | Merchant Principal # Business Phone Number is required | MATCH-400-1009 |
| 400 | Merchant Country is not valid | MATCH-400-1011 |
| 400 | Merchant Principal # Country is not valid | MATCH-400-1011 |
| 400 | Merchant Address Country Subdivision is not valid | MATCH-400-1012 |
| 400 | Merchant Principal # Address Country Subdivision is not valid | MATCH-400-1012 |
| 400 | Merchant Category Code is not valid | MATCH-400-1015 |
| 400 | Merchant Country can contain only letters \[a-zA-Z\] are allowed. | MATCH-400-1020 |
| 400 | Merchant Principal # Country can contain only letters \[a-zA-Z\] are allowed. | MATCH-400-1020 |
| 400 | Merchant Principals are not valid. Duplicate Principals found. | MATCH-400-1021 |
| 400 | Merchant Urls are not valid. Duplicate Urls found. | MATCH-400-1022 |
| 400 | Merchant Url format is not valid | MATCH-400-1024 |
| 400 | Please remove National ID/SSN for Merchant Principal # and try again later. | MATCH-400-1025 |
| 400 | Please remove driver's license number for Merchant Principal # and try again later. | MATCH-400-1026 |
| 400 | Please remove driver's license country for Merchant Principal # and try again later. | MATCH-400-1027 |
| 400 | Please remove driver's license Country Subdivision for Merchant Principal # and try again later. | MATCH-400-1028 |
| 400 | Please remove National Tax ID for Merchant and try again later. | MATCH-400-1030 |
| 400 | Please remove State Tax ID for Merchant and try again later. | MATCH-400-1037 |
| 400 | Minimum Possible Match Count must be between 1 and 9. | MATCH-400-1041 |
| 400 | Merchant Principal # Date of Birth cannot be future date | MATCH-400-1050 |
| 400 | Merchant Principal # Email is required | MATCH-400-1101 |
| 400 | Merchant National Tax ID is required for Brazil country | MATCH-400-1105 |
| 400 | Merchant Principal # National ID is required for Brazil country | MATCH-400-1106 |
| 400 | Merchant Phone Number cannot begin with 0 or 1 for USA | MATCH-400-1111 |
| 400 | Merchant Principal # Phone Number cannot begin with 0 or 1 for USA | MATCH-400-1111 |
| 400 | Merchant Phone Number cannot contain more than 10 digits for USA | MATCH-400-1112 |
| 400 | Merchant Principal # Phone Number cannot contain more than 10 digits for USA | MATCH-400-1112 |
| 400 | Merchant Phone Number is not valid | MATCH-400-1113 |
| 400 | Merchant Principal # Phone Number is not valid | MATCH-400-1113 |
| 400 | Merchant Alternate Phone Number cannot begin with 0 or 1 for USA | MATCH-400-1114 |
| 400 | Merchant Principal # Alternate Phone Number cannot begin with 0 or 1 for USA | MATCH-400-1114 |
| 400 | Merchant Alternate Phone Number cannot contain more than 10 digits for USA | MATCH-400-1115 |
| 400 | Merchant Principal # Alternate Phone Number cannot contain more than 10 digits for USA | MATCH-400-1115 |
| 400 | Merchant Alternate Phone Number is not valid | MATCH-400-1116 |
| 400 | Merchant Principal # Alternate Phone Number is not valid | MATCH-400-1116 |
| 400 | Merchant Phone Number cannot contain more than 25 digits for Non-USA | MATCH-400-1117 |
| 400 | Merchant Principal # Phone Number cannot contain more than 25 digits for Non-USA | MATCH-400-1117 |
| 400 | Merchant Alternate Phone Number cannot contain more than 25 digits for Non-USA | MATCH-400-1118 |
| 400 | Merchant Principal # Alternate Phone Number cannot contain more than 25 digits for Non-USA | MATCH-400-1118 |
| 400 | Merchant Urls list exceeds the maximum allowed limit of 100 | MATCH-400-1126 |
| 400 | Merchant Category code is required | MATCH-400-1130 |
| 400 | Merchant Urls are longer than the maximum allowed length of 1000 | MATCH-400-1136 |
| 400 | Merchant ID is longer than the maximum allowed length of 25 | MATCH-400-1138 |
| 400 | Principal Driver License # Driver's License Number is required | MATCH-400-1144 |
| 400 | Merchant Name is longer than the maximum allowed length of 255 | MATCH-400-1147 |
| 400 | Merchant Doing Business As Name is longer than the maximum allowed length of 255 | MATCH-400-1148 |
| 400 | Merchant National Tax ID is longer than the maximum allowed length of 35 | MATCH-400-1151 |
| 400 | Merchant City can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[ _ (), - . / ' + \& # ? $ \` \] are allowed between start and end letter of city. | MATCH-400-1153 |
| 400 | Merchant Principal # City can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[ _ (), - . / ' + \& # ? $ \` \] are allowed between start and end letter of city. | MATCH-400-1153 |
| 400 | Merchant Principal # FirstName is longer than the maximum allowed length of 255 | MATCH-400-1155 |
| 400 | Merchant Principal # LastName is longer than the maximum allowed length of 255 | MATCH-400-1156 |
| 400 | Merchant Principal # MiddleInitial is longer than the maximum allowed length of 1 | MATCH-400-1157 |
| 400 | Merchant Country Subdivision Tax ID cannot contain more than 35 characters | MATCH-400-1158 |
| 400 | Merchant Address Line 1 is longer than the maximum allowed length of 100 | MATCH-400-1159 |
| 400 | Merchant Principal # Address Line 1 is longer than the maximum allowed length of 100 | MATCH-400-1159 |
| 400 | Merchant Address Line 2 is longer than the maximum allowed length of 100 | MATCH-400-1160 |
| 400 | Merchant Principal # Address Line 2 is longer than the maximum allowed length of 100 | MATCH-400-1160 |
| 400 | Merchant Address City is longer than the maximum allowed length of 30 | MATCH-400-1161 |
| 400 | Merchant Principal # Address City is longer than the maximum allowed length of 30 | MATCH-400-1161 |
| 400 | Merchant Address Country is longer than the maximum allowed length of 3 | MATCH-400-1162 |
| 400 | Merchant Principal # Address Country is longer than the maximum allowed length of 3 | MATCH-400-1162 |
| 400 | Merchant Address Country Subdivision is longer than the maximum allowed length of 3 | MATCH-400-1164 |
| 400 | Merchant Principal # Address Country Subdivision is longer than the maximum allowed length of 3 | MATCH-400-1164 |
| 400 | Merchant Principal # Driver's License Number cannot contain more than 35 characters | MATCH-400-1165 |
| 400 | Merchant Principal # Driver's License Country is longer than the maximum allowed length of 3 | MATCH-400-1166 |
| 400 | Merchant Principal # Driver's License Country Subdivision is longer than the maximum allowed length of 3 | MATCH-400-1167 |
| 400 | Merchant Principal # National ID cannot contain more than 35 characters for Non-USA | MATCH-400-1168 |
| 400 | Merchant Principal # Email is longer than the maximum allowed length of 100 | MATCH-400-1169 |
| 400 | Merchant Principal # Date Of Birth is not valid | MATCH-400-1179 |
| 400 | Principals list exceeds the maximum allowed limit of 5 | MATCH-400-1180 |
| 400 | Merchant Phone Number must be numeric. Cannot contain all zeros, alphabetic, special characters or spaces | MATCH-400-1182 |
| 400 | Merchant Principal # Phone Number must be numeric. Cannot contain all zeros, alphabetic, special characters or spaces | MATCH-400-1182 |
| 400 | Merchant Alternate Phone Number must be numeric. Cannot contain all zeros, alphabetic, special characters or spaces | MATCH-400-1183 |
| 400 | Merchant Principal # Alternate Phone Number must be numeric. Cannot contain all zeros, alphabetic, special characters or spaces | MATCH-400-1183 |
| 400 | Merchant Sub Merchant ID can contain only letters \[A-Za-z\], numbers \[0-9\], and hyphens \[-\] are allowed. | MATCH-400-1184 |
| 400 | Merchant Name can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[!@#$\&\*()'{}''':\^_-;\|.+?,/ \] are allowed. | MATCH-400-1185 |
| 400 | Merchant Doing Business As Name can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[!@#$\&\*()'{}'':\^_-;\|.+?,/ \] are allowed. | MATCH-400-1186 |
| 400 | Merchant Address Line 1 can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[!@#$\^\*_\|:'{}'\[\]-=,. /\~\`\] are allowed. | MATCH-400-1189 |
| 400 | Merchant Principal # Address Line 1 can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[!@#$\^\*_\|:'{}'\[\]-=,. /\~\`\] are allowed. | MATCH-400-1189 |
| 400 | Merchant Address Line 2 can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[!@#$\^\*_\|:'{}'\[\]-=,. /\~\`\] are allowed. | MATCH-400-1190 |
| 400 | Merchant Principal # Address Line 2 can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[!@#$\^\*_\|:'{}'\[\]-=,. /\~\`\] are allowed. | MATCH-400-1190 |
| 400 | Merchant City is not valid | MATCH-400-1191 |
| 400 | Merchant Principal # City is not valid | MATCH-400-1191 |
| 400 | Merchant Principal # First Name can contain only letters \[A-Za-z\], numbers \[0-9\], and spaces are allowed. | MATCH-400-1194 |
| 400 | Merchant Principal # Last Name can contain only letters \[A-Za-z\], numbers \[0-9\], and spaces are allowed. | MATCH-400-1195 |
| 400 | Merchant Principal # MiddleInitial can contain only letters \[A-Za-z\] and numbers \[0-9\] are allowed. | MATCH-400-1196 |
| 400 | Merchant Principal # Email can contain only letters \[a-zA-Z\], numbers \[0-9\], special characters \[! # $ \& \* + / ? @ '{ \| }' \~ \^ - .\], and domain (e.g., .com, .net) | MATCH-400-1197 |
| 400 | Merchant Principal # Driver's License Number can contain only letters \[A-Za-z\], numbers \[0-9\], underscores \[_\], slashes \[/\], hyphens \[-\], and spaces | MATCH-400-1198 |
| 400 | Merchant ID can contain only letters \[a-zA-Z\], numbers \[0-9\], and hyphens \[-\], or be empty allowed. | MATCH-400-1199 |
| 400 | Merchant Sub Merchant ID is longer than the maximum allowed length of 25 | MATCH-400-1200 |
| 400 | Merchant Country Subdivision Tax ID can contain only letters \[A-Za-z\], numbers \[0-9\], hyphens \[-\], underscores \[_\], slashes \[/\], and spaces are allowed. | MATCH-400-1203 |
| 400 | Merchant National Tax ID can contain only letters \[A-Za-z\], numbers \[0-9\], hyphens \[-\], underscores \[_\], slashes \[/\], and spaces are allowed. | MATCH-400-1204 |
| 400 | Merchant Address isOtherCity flag value should be either 'Y' or 'N' | MATCH-400-1205 |
| 400 | Merchant Principal # Address isOtherCity flag value should be either 'Y' or 'N' | MATCH-400-1205 |
| 400 | Merchant Address Country Subdivision is required | MATCH-400-1210 |
| 400 | Merchant Principal # Address Country Subdivision is required | MATCH-400-1210 |
| 400 | Merchant Address Postal Code is required | MATCH-400-1211 |
| 400 | Merchant Principal # Address Postal Code is required | MATCH-400-1211 |
| 400 | Merchant Principal # Driver's License Country Subdivision is required for CANADA, UNITED STATES countries | MATCH-400-1214 |
| 400 | Merchant Address Postal Code cannot contain more than 5 characters for USA | MATCH-400-2005 |
| 400 | Merchant Principal # Address Postal Code cannot contain more than 5 characters for USA | MATCH-400-2005 |
| 400 | Merchant Address Postal Code is not valid | MATCH-400-2105 |
| 400 | Merchant Principal # Address Postal Code is not valid | MATCH-400-2105 |
| 400 | Merchant Address Postal Code cannot contain more than 10 characters for Non-USA | MATCH-400-2106 |
| 400 | Merchant Principal # Address Postal Code cannot contain more than 10 characters for Non-USA | MATCH-400-2106 |
| 400 | Merchant Address Postal Code can contain only \[A-Za-z\], numbers \[0-9\], hyphens \[-\], and spaces are allowed. | MATCH-400-2107 |
| 400 | Merchant Principal # Address Postal Code can contain only \[A-Za-z\], numbers \[0-9\], hyphens \[-\], and spaces are allowed. | MATCH-400-2107 |
| 400 | Page offset should not be negative. | BAD_REQUEST |
| 400 | Page length should be in range 1 to 100. | BAD_REQUEST |
#### Termination Inquiry History Request {#termination-inquiry-history-request}
| HTTP Status CODE | ERROR MESSAGE | MATCH API RESPONSE CODE |
|------------------|------------------------------------------|-------------------------|
| 403 | Invalid IRN | INVALID_INPUT_VALUE |
| 403 | IRN is Not present in DB | INVALID_INPUT_VALUE |
| 400 | Page offset should not be negative. | BAD_REQUEST |
| 400 | Page length should be in range 1 to 100. | BAD_REQUEST |
#### Add Terminated Merchant {#add-terminated-merchant}
| HTTP Status CODE | ERROR MESSAGE | MATCH API RESPONSE CODE |
|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------|
| 400 | Merchant Country is required | MATCH-400-1001 |
| 400 | Merchant Principal # Country is required | MATCH-400-1001 |
| 400 | Merchant City is required | MATCH-400-1002 |
| 400 | Merchant Principal # City is required | MATCH-400-1002 |
| 400 | Merchant Name is required | MATCH-400-1003 |
| 400 | Merchant Address Country Subdivision is required for CANADA, UNITED STATES countries | MATCH-400-1004 |
| 400 | Merchant Principal # Address Country Subdivision is required for CANADA, UNITED STATES countries | MATCH-400-1004 |
| 400 | Merchant Postal Code is required for CANADA, UNITED STATES countries | MATCH-400-1005 |
| 400 | Merchant Principal # Postal Code is required for CANADA, UNITED STATES countries | MATCH-400-1005 |
| 400 | Merchant Principal # FirstName is required | MATCH-400-1006 |
| 400 | Merchant Principal # LastName is required | MATCH-400-1007 |
| 400 | Merchant Address line1 is required | MATCH-400-1008 |
| 400 | Merchant Principal # Address line1 is required | MATCH-400-1008 |
| 400 | Merchant Country is not valid | MATCH-400-1011 |
| 400 | Merchant Principal # Country is not valid | MATCH-400-1011 |
| 400 | Merchant Address Country Subdivision is not valid | MATCH-400-1012 |
| 400 | Merchant Principal # Address Country Subdivision is not valid | MATCH-400-1012 |
| 400 | Merchant Category Code is not valid | MATCH-400-1015 |
| 400 | Merchant Closed Date cannot be before Opened Date | MATCH-400-1019 |
| 400 | Merchant Country can contain only letters \[a-zA-Z\] are allowed. | MATCH-400-1020 |
| 400 | Merchant Principal # Country can contain only letters \[a-zA-Z\] are allowed. | MATCH-400-1020 |
| 400 | Merchant Principals are not valid. Duplicate Principals found. | MATCH-400-1021 |
| 400 | Merchant Urls are not valid. Duplicate Urls found. | MATCH-400-1022 |
| 400 | Merchant Reason Code is not valid | MATCH-400-1023 |
| 400 | Merchant Url format is not valid | MATCH-400-1024 |
| 400 | Please remove National ID/SSN for Merchant Principal # and try again later. | MATCH-400-1025 |
| 400 | Please remove driver's license number for Merchant Principal # and try again later. | MATCH-400-1026 |
| 400 | Please remove driver's license country for Merchant Principal # and try again later. | MATCH-400-1027 |
| 400 | Please remove driver's license Country Subdivision for Merchant Principal # and try again later. | MATCH-400-1028 |
| 400 | Please remove ADC Event Case ID and try again later | MATCH-400-1029 |
| 400 | Please remove National Tax ID for Merchant and try again later. | MATCH-400-1030 |
| 400 | ADC Event Case ID required for Reason code-01 | MATCH-400-1034 |
| 400 | Please remove State Tax ID for Merchant and try again later. | MATCH-400-1037 |
| 400 | Merchant Principal # Date of Birth cannot be future date | MATCH-400-1050 |
| 400 | Merchant Principal # Email is required | MATCH-400-1101 |
| 400 | Merchant National Tax ID is required for Brazil country | MATCH-400-1105 |
| 400 | Merchant Principal # National ID is required for Brazil country | MATCH-400-1106 |
| 400 | Merchant Phone Number cannot begin with 0 or 1 for USA | MATCH-400-1111 |
| 400 | Merchant Principal # Phone Number cannot begin with 0 or 1 for USA | MATCH-400-1111 |
| 400 | Merchant Phone Number cannot contain more than 10 digits for USA | MATCH-400-1112 |
| 400 | Merchant Principal # Phone Number cannot contain more than 10 digits for USA | MATCH-400-1112 |
| 400 | Merchant Phone Number is not valid | MATCH-400-1113 |
| 400 | Merchant Principal # Phone Number is not valid | MATCH-400-1113 |
| 400 | Merchant Alternate Phone Number cannot begin with 0 or 1 for USA | MATCH-400-1114 |
| 400 | Merchant Principal # Alternate Phone Number cannot begin with 0 or 1 for USA | MATCH-400-1114 |
| 400 | Merchant Alternate Phone Number cannot contain more than 10 digits for USA | MATCH-400-1115 |
| 400 | Merchant Principal # Alternate Phone Number cannot contain more than 10 digits for USA | MATCH-400-1115 |
| 400 | Merchant Alternate Phone Number is not valid | MATCH-400-1116 |
| 400 | Merchant Principal # Alternate Phone Number is not valid | MATCH-400-1116 |
| 400 | Merchant Phone Number cannot contain more than 25 digits for Non-USA | MATCH-400-1117 |
| 400 | Merchant Principal # Phone Number cannot contain more than 25 digits for Non-USA | MATCH-400-1117 |
| 400 | Merchant Alternate Phone Number cannot contain more than 25 digits for Non-USA | MATCH-400-1118 |
| 400 | Merchant Principal # Alternate Phone Number cannot contain more than 25 digits for Non-USA | MATCH-400-1118 |
| 400 | Merchant ADC Event Case ID can contain only letters \[A-Za-z\], numbers \[0-9\], and hyphens \[-\] are allowed. | MATCH-400-1125 |
| 400 | Merchant Urls list exceeds the maximum allowed limit of 100 | MATCH-400-1126 |
| 400 | Merchant Proprietorship flag is required | MATCH-400-1128 |
| 400 | Merchant Transaction Laundering flag is required | MATCH-400-1129 |
| 400 | Merchant Category code is required | MATCH-400-1130 |
| 400 | Merchant Reason code is required | MATCH-400-1131 |
| 400 | Merchant Urls are longer than the maximum allowed length of 1000 | MATCH-400-1136 |
| 400 | Merchant ID is required | MATCH-400-1137 |
| 400 | Merchant ID is longer than the maximum allowed length of 25 | MATCH-400-1138 |
| 400 | Merchant Phone Number is required | MATCH-400-1039 |
| 400 | Merchant Principal # Phone Number is required | MATCH-400-1039 |
| 400 | Merchant Date Opened is required | MATCH-400-1140 |
| 400 | Merchant Date Closed is required | MATCH-400-1141 |
| 400 | Merchant Principal # Driver's License Country is not valid | MATCH-400-1142 |
| 400 | Merchant Principal # Driver's License Country Subdivision is not valid | MATCH-400-1143 |
| 400 | Merchant Principal # Driver's License Number is required | MATCH-400-1144 |
| 400 | Merchant Proprietorship flag value should be either 'Y' or 'N' | MATCH-400-1146 |
| 400 | Merchant Name is longer than the maximum allowed length of 255 | MATCH-400-1147 |
| 400 | Merchant Doing Business As Name is longer than the maximum allowed length of 255 | MATCH-400-1148 |
| 400 | Merchant National Tax ID is longer than the maximum allowed length of 35 | MATCH-400-1151 |
| 400 | Merchant City can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[ _ (), - . / ' + \& # ? $ \` \] are allowed between start and end letter of city. | MATCH-400-1153 |
| 400 | Merchant Principal # City can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[ _ (), - . / ' + \& # ? $ \` \] are allowed between start and end letter of city. | MATCH-400-1153 |
| 400 | Merchant Transaction Laundering flag value should be either 'Y' or 'N' | MATCH-400-1154 |
| 400 | Merchant Principal # FirstName is longer than the maximum allowed length of 255 | MATCH-400-1155 |
| 400 | Merchant Principal # LastName is longer than the maximum allowed length of 255 | MATCH-400-1156 |
| 400 | Merchant Principal # MiddleInitial is longer than the maximum allowed length of 1 | MATCH-400-1157 |
| 400 | Merchant Country Subdivision Tax ID cannot contain more than 35 characters | MATCH-400-1158 |
| 400 | Merchant Address Line 1 is longer than the maximum allowed length of 100 | MATCH-400-1159 |
| 400 | Merchant Principal # Address Line 1 is longer than the maximum allowed length of 100 | MATCH-400-1159 |
| 400 | Merchant Address Line 2 is longer than the maximum allowed length of 100 | MATCH-400-1160 |
| 400 | Merchant Principal # Address Line 2 is longer than the maximum allowed length of 100 | MATCH-400-1160 |
| 400 | Merchant Address City is longer than the maximum allowed length of 30 | MATCH-400-1161 |
| 400 | Merchant Principal # Address City is longer than the maximum allowed length of 30 | MATCH-400-1161 |
| 400 | Merchant Address Country is longer than the maximum allowed length of 3 | MATCH-400-1162 |
| 400 | Merchant Principal # Address Country is longer than the maximum allowed length of 3 | MATCH-400-1162 |
| 400 | Merchant Address Country Subdivision is longer than the maximum allowed length of 3 | MATCH-400-1164 |
| 400 | Merchant Principal # Address Country Subdivision is longer than the maximum allowed length of 3 | MATCH-400-1164 |
| 400 | Merchant Principal # Driver's License Number cannot contain more than 35 characters | MATCH-400-1165 |
| 400 | Merchant Principal # Driver's License Country is longer than the maximum allowed length of 3 | MATCH-400-1166 |
| 400 | Merchant Principal # Driver's License Country Subdivision is longer than the maximum allowed length of 3 | MATCH-400-1167 |
| 400 | Merchant Principal # National ID cannot contain more than 35 characters for Non-USA | MATCH-400-1168 |
| 400 | Merchant Principal # Email is longer than the maximum allowed length of 100 | MATCH-400-1169 |
| 400 | Merchant Date Opened is not valid | MATCH-400-1177 |
| 400 | Merchant Date Closed is not valid | MATCH-400-1178 |
| 400 | Merchant Principal # Date Of Birth is not valid | MATCH-400-1179 |
| 400 | Principals list exceeds the maximum allowed limit of 5 | MATCH-400-1180 |
| 400 | Merchant Phone Number must be numeric. Cannot contain all zeros, alphabetic, special characters or spaces | MATCH-400-1182 |
| 400 | Merchant Principal # Phone Number must be numeric. Cannot contain all zeros, alphabetic, special characters or spaces | MATCH-400-1182 |
| 400 | Merchant Alternate Phone Number must be numeric. Cannot contain all zeros, alphabetic, special characters or spaces | MATCH-400-1183 |
| 400 | Merchant Principal # Alternate Phone Number must be numeric. Cannot contain all zeros, alphabetic, special characters or spaces | MATCH-400-1183 |
| 400 | Merchant Sub Merchant ID can contain only letters \[A-Za-z\], numbers \[0-9\], and hyphens \[-\] are allowed. | MATCH-400-1184 |
| 400 | Merchant Name can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[!@#$\&\*()'{}''':\^_-;\|.+?,/ \] are allowed. | MATCH-400-1185 |
| 400 | Merchant Doing Business As Name can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[!@#$\&\*()'{}'':\^_-;\|.+?,/ \] are allowed. | MATCH-400-1186 |
| 400 | Merchant Address Line 1 can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[!@#$\^\*_\|:'{}'\[\]-=,. /\~\`\] are allowed. | MATCH-400-1189 |
| 400 | Merchant Principal # Address Line 1 can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[!@#$\^\*_\|:'{}'\[\]-=,. /\~\`\] are allowed. | MATCH-400-1189 |
| 400 | Merchant Address Line 2 can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[!@#$\^\*_\|:'{}'\[\]-=,. /\~\`\] are allowed. | MATCH-400-1190 |
| 400 | Merchant Principal # Address Line 2 can contain only letters \[A-Za-z\], numbers \[0-9\], and special characters \[!@#$\^\*_\|:'{}'\[\]-=,. /\~\`\] are allowed. | MATCH-400-1190 |
| 400 | Merchant City is not valid | MATCH-400-1191 |
| 400 | Merchant Principal # City is not valid | MATCH-400-1191 |
| 400 | Merchant Address Province can contain only letters \[A-Za-z\] and numbers \[0-9\] | MATCH-400-1192 |
| 400 | Merchant Principal # Address Province can contain only letters \[A-Za-z\] and numbers \[0-9\] | MATCH-400-1192 |
| 400 | Merchant Address Province is longer than the maximum allowed length of 3 | MATCH-400-1193 |
| 400 | Merchant Principal # Address Province is longer than the maximum allowed length of 3 | MATCH-400-1193 |
| 400 | Merchant Principal # First Name can contain only letters \[A-Za-z\], numbers \[0-9\], and spaces are allowed. | MATCH-400-1194 |
| 400 | Merchant Principal # Last Name can contain only letters \[A-Za-z\], numbers \[0-9\], and spaces are allowed. | MATCH-400-1195 |
| 400 | Merchant Principal # MiddleInitial can contain only letters \[A-Za-z\] and numbers \[0-9\] are allowed. | MATCH-400-1196 |
| 400 | Merchant Principal # Email can contain only letters \[a-zA-Z\], numbers \[0-9\], special characters \[! # $ \& \* + / ? @ '{ \| }' \~ \^ - .\], and domain (e.g., .com, .net) | MATCH-400-1197 |
| 400 | Merchant Principal # Driver's License Number can contain only letters \[A-Za-z\], numbers \[0-9\], underscores \[_\], slashes \[/\], hyphens \[-\], and spaces | MATCH-400-1198 |
| 400 | Merchant ID can contain only letters \[a-zA-Z\], numbers \[0-9\], and hyphens \[-\], or be empty allowed. | MATCH-400-1199 |
| 400 | Merchant Sub Merchant ID is longer than the maximum allowed length of 25 | MATCH-400-1200 |
| 400 | Merchant Country Subdivision Tax ID can contain only letters \[A-Za-z\], numbers \[0-9\], hyphens \[-\], underscores \[_\], slashes \[/\], and spaces are allowed. | MATCH-400-1203 |
| 400 | Merchant National Tax ID can contain only letters \[A-Za-z\], numbers \[0-9\], hyphens \[-\], underscores \[_\], slashes \[/\], and spaces are allowed. | MATCH-400-1204 |
| 400 | Merchant Address isOtherCity flag value should be either 'Y' or 'N' | MATCH-400-1205 |
| 400 | Merchant Principal # Address isOtherCity flag value should be either 'Y' or 'N' | MATCH-400-1205 |
| 400 | Merchant Principal # Driver's License Country Subdivision is required for CANADA, UNITED STATES countries | MATCH-400-1208 |
| 400 | Merchant Principal # Date Of Birth is required | MATCH-400-1209 |
| 400 | Merchant Address Country Subdivision is required | MATCH-400-1210 |
| 400 | Merchant Principal # Address Country Subdivision is required | MATCH-400-1210 |
| 400 | Merchant Address Postal Code is required | MATCH-400-1211 |
| 400 | Merchant Principal # Address Postal Code is required | MATCH-400-1211 |
| 400 | Merchant ADC Event Case ID is longer than the maximum allowed length of 20 | MATCH-400-1213 |
| 400 | Merchant Address Postal Code cannot contain more than 5 characters for USA | MATCH-400-2005 |
| 400 | Merchant Principal # Address Postal Code cannot contain more than 5 characters for USA | MATCH-400-2005 |
| 400 | Merchant Address Postal Code is not valid | MATCH-400-2105 |
| 400 | Merchant Principal # Address Postal Code is not valid | MATCH-400-2105 |
| 400 | Merchant Address Postal Code cannot contain more than 10 characters for Non-USA | MATCH-400-2106 |
| 400 | Merchant Principal # Address Postal Code cannot contain more than 10 characters for Non-USA | MATCH-400-2106 |
| 400 | Merchant Address Postal Code can contain only \[A-Za-z\], numbers \[0-9\], hyphens \[-\], and spaces are allowed. | MATCH-400-2107 |
| 400 | Merchant Principal # Address Postal Code can contain only \[A-Za-z\], numbers \[0-9\], hyphens \[-\], and spaces are allowed. | MATCH-400-2107 |
| 400 | Page offset should not be negative. | BAD_REQUEST |
| 400 | Page length should be in range 1 to 100. | BAD_REQUEST |
#### Acquirer Contact Request {#acquirer-contact-request}
| HTTP Status CODE | ERROR MESSAGE | MATCH API RESPONSE CODE |
|------------------|--------------------------------------------------------------|-------------------------|
| 400 | Acquirer Id is required | INVALID_INPUT_VALUE |
| 400 | Acquirer Id must be numeric | INVALID_INPUT_VALUE |
| 404 | Contact information is not present for the given Acquirer Id | RESPONSE_DATA_NO_RESULT |
| 400 | Acquirer Id is longer than the maximum allowed length of 11 | INVALID_INPUT_VALUE |
#### Retroactive Inquiry Request {#retroactive-inquiry-request}
| HTTP Status CODE | ERROR MESSAGE | MATCH API RESPONSE CODE |
|------------------|------------------------------------------|-------------------------|
| 400 | Page offset should not be negative. | BAD_REQUEST |
| 400 | Page length should be in range 1 to 100. | BAD_REQUEST |
#### Retroactive Inquiry Details Request {#retroactive-inquiry-details-request}
| HTTP Status CODE | ERROR MESSAGE | MATCH API RESPONSE CODE |
|------------------|-------------------------------------------------------------------------|-------------------------|
| 400 | Retro information is not present for the given inquiry reference number | RESPONSE_DATA_NO_RESULT |
| 403 | IRN is Not present in DB | INVALID_INPUT_VALUE |
| 403 | Invalid IRN | INVALID_INPUT_VALUE |
#### State Request {#state-request}
| HTTP Status CODE | ERROR MESSAGE | MATCH API RESPONSE CODE |
|------------------|---------------------------|-------------------------|
| 400 | Country Code is not valid | MATCH-400-1039 |
| 400 | Argument Type mismatch | BAD_REQUEST |
#### City Request {#city-request}
| HTTP Status CODE | ERROR MESSAGE | MATCH API RESPONSE CODE |
|------------------|---------------------------|-------------------------|
| 400 | Country Code is not valid | MATCH-400-1039 |
| 400 | State Code is not valid | MATCH-400-1040 |
| 400 | Argument Type mismatch | BAD_REQUEST |