# Code and Formats source: https://developer.mastercard.com/account-catalog-services/documentation/code-and-formats/index.md ## HTTP Status Codes/Reason Codes {#http-status-codesreason-codes} Resource requests use HTTP response codes to provide a coarse-grain indication of the result of each request. The most common expected response codes for the supported HTTP methods are as follows: | HTTP status code | Reason Code | Response Description | Resolution Tips | |--------------------|-------------------|---------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------| | 200 (OK) | N/A | The request was completed successfully. | No action needed - request processed successfully. | | 201 (CREATED) | N/A | Successful creation occurred using a POST request. The Location header will contain a link to the newly-created resource. | No action needed - resource created successfully. Check Location header for new resource URL. | | 204 (NO CONTENT) | N/A | The server successfully processed the request and is not returning any content. | No action needed - resource updated/deleted successfully. | | 400 (BAD REQUEST) | BAD_REQUEST | General error when the request could not be fulfilled due to errors such as validation errors or missing required data. | Validate request parameters, check required fields, and ensure proper data formats before retrying. | | 401 (UNAUTHORIZED) | UNAUTHORIZED | Missing or invalid authentication token. | Verify authentication credentials, refresh tokens if expired, and ensure proper authorization headers are included. | | 403 (FORBIDDEN) | PERMISSION_DENIED | The user has insufficient permissions to a resource or action. | Contact administrator to verify user permissions or use an account with appropriate access rights. | | 404 (NOT FOUND) | NOT_FOUND | The requested resource was not found. | Verify the resource URL/ID is correct and the resource exists. Check for typos in the endpoint path. | ## Gateway Error Codes {#gateway-error-codes} Apart from the error codes returned by the Account Catalog Services API, error codes can be returned by the Mastercard gateway, which verifies your request's signature and routes to the correct location. Under certain conditions, you might receive errors from our API gateway. New error codes can be added at any time. For a current and full listing of all error codes that can be triggered by the Mastercard API Gateway, refer to [Gateway Error Codes](https://developer.mastercard.com/platform/documentation/security-and-authentication/gateway-error-codes/). ## Error Structure {#error-structure} To ensure a consistent experience across all Mastercard APIs, the following structure is followed by the Account Catalog Services API for each error scenario that can occur. **Single Error:** ```json { "Errors": { "Error": [ { "Source": "", "ReasonCode": "", "Description": "", "Recoverable": "", } ] } } ``` **Multiple Errors:** ```json { "Errors": { "Error": [ { "Source": "", "ReasonCode": "", "Description": "", "Recoverable": "", "Details": "" },{ "Source": "", "ReasonCode": "", "Description": "", "Recoverable": "", "Details": "" } ] } } ``` | Field | Description | |-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Source** | The application that generated this error. Every error message that is generated and returned by the Gateway will have this field set to `Gateway`. If the field value is `Account Catalog Services_API`, then the error is generated by the Account Catalog Services application. | | **ReasonCode** | A unique constant identifies the error case encountered when any Account Catalog Services API is called. For example, `NOT_FOUND` is used when the requested resource does not exist. | | **Description** | Description of the `ReasonCode` field provided with additional details. | | **Recoverable** | Indicates whether this error will always be returned for this request, or retrying could change the outcome. For example, if the request contains an invalid request parameter, retrying will never result in success. However, if the error is related to some unexpected timeout with the service, retrying the call could result in a successful response. | The error codes returned will depend on which API generated the error and at what point the request failed. Error messages are in one of the following formats: * **Mastercard Gateway Error Messages**: Returned from the gateway and typically occur when OAuth 1.0a authentication fails. * **Account Catalog Services API Error Messages**: Returned from the Account Catalog Services application and typically occur for incorrect input errors. ## Mastercard Account Catalog Services endpoint error codes {#mastercard-account-catalog-services-endpoint-error-codes} For a current and full listing of all rejected error codes that can be triggered by the Account Catalog Services Platform, refer to the following section: New Reject Response and Error Reason Codes have been created in support of the API processing. An API response (or an object within the response) contains the elements `errorCode` and `errorDescription` as defined in the Error Reason Codes. | **Reject Code** | **Description** | **Applicable for HTTP Endpoint** | **Message** | **Resolution Tips** | **Response Code** | |-----------------|--------------------------------------------------------------------------------------------------------|----------------------------------|--------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------| | R0000370 | Request ID, provided in the header, is required and must be present | POST, PUT, DELETE, GET | Acknowledgement Error Response | Check if request ID is provided in the header, if not then add unique request ID. | 400 | | R0000376 | Request ID must be alphanumeric or contain valid special characters and may not contain spaces | POST, PUT, DELETE, GET | Acknowledgement Error Response | The Request ID should be revalidated as per the specification. | 400 | | R0000377 | Request ID must not exceed 255 positions | POST, PUT, DELETE, GET | Acknowledgement Error Response | The Request ID length should be revalidated and corrected as per the specification. | 400 | | R0000372 | Authorization (Consumer Key + Client ID) not approved/provisioned for the issuer's Company Identifier | POST, PUT, DELETE, GET | Acknowledgement Error Response | The consumer key provided at the time of project creation should be used. If access to the API is not granted or the consumer key is not generated, then contact customer support. | 401 | | R0000371 | Request ID is a duplicate and used on a previous submission | POST, PUT, DELETE | Acknowledgement Error Response | Generate new request ID and provide in header. Previous request ID should not be used. | 400 | | R0000373 | API request has incorrect JSON format (invalid JSON schema) | POST, PUT, DELETE | Acknowledgement Error Response | Check the JSON format of the request and correct it | 400 | | R0000379 | JSON parse error: Duplicate field '\[field name\]' | POST, PUT, DELETE | Acknowledgement Error Response | Remove the duplicate field from request payload | 400 | | R0000385 | Request not processed successfully due to system failure | POST, PUT, DELETE, GET | Acknowledgement Error Response | If in recoverable field's value of error response is true, then retry request else contact to customer support team. | 500 | | R0009050 | Domain not found for a given record | POST, PUT, DELETE | Acknowledgement Error Response | Domain not found for a given record. | 408 † | | R0009500 | Domain response not received (timeout) | POST, PUT, DELETE | Acknowledgement Error Response | Unable to process the request because a response from the domain was not received. | 408 | | R0009124 | Services provided in the query parameter contain one or more invalid values | DELETE | Acknowledgement Error Response | Services List provided in the query param, contain one or more invalid values. | 400 | | R0009200 | The query parameter 'correlation_id' must be provided | GET | Acknowledgement Error Response | correlation_id must be present. | 400 | | R0009201 | The query parameter 'correlation_id' contains invalid characters | GET | Acknowledgement Error Response | correlation_id is not valid. | 400 | | R0009203 | The length of 'correlation_id' exceeds 255 characters | GET | Acknowledgement Error Response | correlation_id length is invalid. | 400 | | R0009204 | The consumer is not authorized to access information for the specified 'correlation_id' | GET | Acknowledgement Error Response | Invalid consumer provided. | 403 | | R0009205 | The GET operation is not supported for the specified 'correlation_id' | GET | Acknowledgement Error Response | Not supported for specified correlation_id | 403 | | R0009206 | No data found for the specified 'correlation_id' | GET | Acknowledgement Error Response | No data found for this correlation_id | 404 | | R0000006 | PAN must be present | POST, PUT, DELETE | Acknowledgement Error Response | PAN must be present. | 400 | | R0000007 | PAN must be numeric | POST, PUT, DELETE | Acknowledgement Error Response | PAN must be numeric | 400 | | R0000008 | PAN must be 13-19 positions | POST, PUT, DELETE | Acknowledgement Error Response | PAN must be 13-19 positions. | 400 | | R0000035 | PAN failed MOD10 validation | POST, PUT, DELETE | Acknowledgement Error Response | PAN failed MOD10 validation | 400 | | R0009122 | Product Rules size must not exceed 10 | POST, PUT, DELETE | Acknowledgement Error Response | Product must not be alphabet only. | 400 | | R0009127 | 'accountLevelManagement' may not be combined with deprecated 'accountLevelManagementServiceProperties' | POST | Acknowledgement Error Response | *(not in Reject-Codes PDF; processor returns 400)* | 400 | | R0009075 | Account Indicator must be present | POST, PUT | Acknowledgement Error Response | Account Indicator must be present | 400 | | R0009129 | Account Indicator must be a valid value (M, E, C, F, H, L, P, R, V) | POST, PUT | Acknowledgement Error Response | *(not in Reject-Codes PDF; processor returns 400)* | 400 | | R0000010 | PAN Status, when present, must be A or C | POST, PUT | Acknowledgement Error Response | PAN Status, when present, must contain a valid value of A or C | 400 | | R0000012 | PAN Closed Date must be valid date (YYYYMMDD) or 8 "X" to remove | POST, PUT | Acknowledgement Error Response | PAN Close Date, when present, must be in a valid date format (YYYYMMDD) and contain a valid date, or all 8 positions containing "X" to remove from the PAN on record. | 400 | | R0000136 | PAN Closed Date must not exceed 8 positions | POST, PUT | Acknowledgement Error Response | PAN Closed Date must not exceed 8 positions | 400 | | R0000014 | Replaced PAN, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | Replaced PAN, when present, must be alphanumeric or may contain trailing spaces | 400 | | R0000015 | Replaced PAN must be 13-19 positions or 19 "X" to remove | POST, PUT | Acknowledgement Error Response | Replaced PAN, when present, must be 13-19 positions or all 19 positions containing "X" to remove the Replaced PAN | 400 | | R0000036 | Replaced PAN failed MOD10 validation | POST, PUT | Acknowledgement Error Response | Replaced PAN failed MOD10 validation | 400 | | R0000382 | Replaced PAN must not have leading or embedded spaces | POST, PUT | Acknowledgement Error Response | Replaced PAN, when present, must not have leading or embedded spaces | 400 | | R0000017 | Replaced PAN Closed Date must be valid date (YYYYMMDD) or 8 "X" to remove | POST, PUT | Acknowledgement Error Response | Replaced PAN Closed Date, when present, must be in a valid date format (YYYYMMDD) and contain a valid date, or all 8 positions containing "X" to remove the Replaced PAN Closed Date. | 400 | | R0000137 | Replaced PAN Closed Date must be less than 9 positions | POST, PUT | Acknowledgement Error Response | Replaced PAN Closed Date must be less than 9 positions | 400 | | R0009132 | Account Identifier Expiration Date should be in MMYY format | POST, PUT | Acknowledgement Error Response | Account Identifier Expiration Date should be in the MMYY format. | 400 | | R0009133 | Replaced Account Identifier Expiration Date should be in MMYY format | POST, PUT | Acknowledgement Error Response | Replaced Account Identifier Expiration Date should be in the MMYY format. | 400 | | R0000031 | Customer Provided ID, when present, must be alphanumeric or spaces | POST, PUT | Acknowledgement Error Response | Customer Provided ID, when present, must be alphanumeric or may contain trailing spaces or must contain valid special characters | 400 | | R0000032 | Customer Provided ID, when present, must not exceed 25 positions | POST, PUT | Acknowledgement Error Response | Customer Provided ID, when present, must not exceed 25 positions | 400 | | R0000358 | Customer Provided ID, when present, must not have leading spaces | POST, PUT | Acknowledgement Error Response | Customer Provided ID, when present, must not have leading spaces | 400 | | R0000019 | Group ID, when present, must be alphanumeric or spaces | POST, PUT | Acknowledgement Error Response | Group ID, when present, must be alphanumeric or may contain trailing spaces or must contain valid special characters | 400 | | R0000020 | Group ID, if present, must not exceed 25 positions | POST, PUT | Acknowledgement Error Response | Group ID, when present, must not exceed 25 positions | 400 | | R0000381 | Group ID, when present, must not have leading spaces | POST, PUT | Acknowledgement Error Response | Group ID, when present, must not have leading spaces | 400 | | R0000021 | Product Graduation Product Code, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | Product Graduation Product Code, when present, must be alphanumeric. | 400 | | R0000022 | Product Graduation Product Code must not exceed 3 positions or 3 "X" to remove | POST, PUT | Acknowledgement Error Response | Product Graduation Product Code, when present, must not exceed 3 positions or all 3 positions must contain "X" to remove the Product Graduation Product Code. | 400 | | R0000200 | Registered Product Code, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | Registered Product Code, when present, must be alphanumeric | 400 | | R0000201 | Registered Product Code must not exceed 3 positions or 3 "X" to remove | POST, PUT | Acknowledgement Error Response | Registered Product Code must not exceed 3 positions, or all 3 positions must contain "X" to remove | 400 | | R0000023 | Program ID, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | Program ID, when present, must be alphanumeric | 400 | | R0000024 | Program ID must not exceed 6 positions or 6 "X" to remove | POST, PUT | Acknowledgement Error Response | Program ID, when present, must not exceed 6 positions or all 6 positions must contain "X" to remove the Program ID. | 400 | | R0000216 | Product Open Date must be valid date (YYYYMMDD) or 8 "X" to remove | POST, PUT | Acknowledgement Error Response | Product Open Date, when present, must be a valid date format (YYYYMMDD) and a valid date or all 8 positions containing X to remove from the PAN record | 400 | | R0000217 | Product Open Date can not be future dated | POST, PUT | Acknowledgement Error Response | Product Open Date cannot be future dated | 400 | | R0000025 | Exception Processing Code 1, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | cc Processing Code 1, when present, must be alphanumeric | 400 | | R0000026 | Exception Processing Code 1 must not exceed 6 positions or 6 "X" to remove | POST, PUT | Acknowledgement Error Response | cc Processing Code 1, when present, must not exceed 6 positions or all 6 positions must contain "X" to remove from the PAN. | 400 | | R0000027 | Exception Processing Code 2, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | cc Processing Code 2, when present, must be alphanumeric | 400 | | R0000028 | Exception Processing Code 2 must not exceed 6 positions or 6 "X" to remove | POST, PUT | Acknowledgement Error Response | cc Processing Code 2, when present, must not exceed 6 positions or all 6 positions must contain "X" to remove from the PAN. | 400 | | R0000029 | Exception Processing Code 3, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | cc Processing Code 3, when present, must be alphanumeric | 400 | | R0000030 | Exception Processing Code 3 must not exceed 6 positions or 6 "X" to remove | POST, PUT | Acknowledgement Error Response | cc Processing Code 3, when present, must not exceed 6 positions or all 6 positions must contain "X" to remove from the PAN. | 400 | | R0000037 | Exception Processing Code 4, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | cc Processing Code 4, when present, must be alphanumeric | 400 | | R0000038 | Exception Processing Code 4 must not exceed 6 positions or 6 "X" to remove | POST, PUT | Acknowledgement Error Response | cc Processing Code 4, when present, must not exceed 6 positions or all 6 positions must contain "X" to remove from the PAN. | 400 | | R0000039 | Exception Processing Code 5, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | cc Processing Code 5, when present, must be alphanumeric | 400 | | R0000040 | Exception Processing Code 5 must not exceed 6 positions or 6 "X" to remove | POST, PUT | Acknowledgement Error Response | cc Processing Code 5, when present, must not exceed 6 positions or all 6 positions must contain "X" to remove from the PAN. | 400 | | R0000300 | Exception Processing Code 6, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | cc Processing Code 6, when present, must be alphanumeric | 400 | | R0000301 | Exception Processing Code 6 must not exceed 6 positions or 6 "X" to remove | POST, PUT | Acknowledgement Error Response | cc Processing Code 6, when present, must not exceed 6 positions or all 6 positions must contain "X" to remove from the PAN. | 400 | | R0000315 | Exception Processing Code 7, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | cc Processing Code 7, when present, must be alphanumeric | 400 | | R0000316 | Exception Processing Code 7 must not exceed 6 positions or 6 "X" to remove | POST, PUT | Acknowledgement Error Response | cc Processing Code 7, when present, must not exceed 6 positions or all 6 positions must contain "X" to remove from the PAN | 400 | | R0000231 | Co-Brand Type, if present, must be alpha | POST, PUT | Acknowledgement Error Response | Co-Brand Type, if present, must be alpha | 400 | | R0000232 | Co-Brand Type must not exceed 3 positions or 3 "X" to clear | POST, PUT | Acknowledgement Error Response | Co-Brand Type, if present, must not exceed 3 positions or must contain all 3 positions of "X" to clear | 400 | | R0000235 | Co-Brand Type, if present, must contain a valid value | POST, PUT | Acknowledgement Error Response | Co-Brand Type, if present, must contain a valid value | 400 | | R0000283 | All Co-Brand fields are required when removing from the PAN record | POST, PUT | Acknowledgement Error Response | All Co-Brand fields are required when removing from the PAN record | 400 | | R0000261 | Co-Brand Program Name, if present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | Co-Brand Program Name, when present, must be alphanumeric or valid special characters | 400 | | R0000262 | Co-Brand Program Name must not exceed 30 positions or 30 "X" to clear | POST, PUT | Acknowledgement Error Response | Co-Brand Program Name, if present, must not exceed 30 positions or must contain all 30 positions of "X to clear | 400 | | R0000276 | Co-Brand Partner Name, if present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | Co-Brand Partner Name, when present, must be alphanumeric or valid special characters | 400 | | R0000277 | Co-Brand Partner Name must not exceed 30 positions or 30 "X" to clear | POST, PUT | Acknowledgement Error Response | Co-Brand Partner Name, if present, must not exceed 30 positions or must contain all 30 positions of "X to clear | 400 | | R0000263 | Co-Brand Type must be provided if Co-Brand Program Name is provided | POST, PUT | Acknowledgement Error Response | Co-Brand Type must be provided if Co-Brand Program Name is provided | 400 | | R0000264 | Co-Brand Partner Name must be provided if Co-Brand Program Name is provided | POST, PUT | Acknowledgement Error Response | Co-Brand Partner Name must be provided if Co-Brand Program Name is provided | 400 | | R0000278 | Co-Brand Type must be provided if Co-Brand Partner Name is provided | POST, PUT | Acknowledgement Error Response | Co-Brand Type must be provided if Co-Brand Partner Name is provided | 400 | | R0000279 | Co-Brand Program Name must be provided if Co-Brand Partner Name is provided | POST, PUT | Acknowledgement Error Response | Co-Brand Program Name must be provided if Co-Brand Partner Name is provided | 400 | | R0000291 | Reward Type, if present, must be alpha | POST, PUT | Acknowledgement Error Response | Reward Type, if present, must be alpha | 400 | | R0000292 | Reward Type must not exceed 3 positions or 3 "X" to clear | POST, PUT | Acknowledgement Error Response | Reward Type, if present, must not exceed 3 positions or must contain all 3 positions as X to clear | 400 | | R0000363 | Reward Type, if present, must contain a valid value | POST, PUT | Acknowledgement Error Response | Reward Type, if present, must contain a valid value | 400 | | R0009128 | Product Rule ID length is not valid | POST, PUT | Acknowledgement Error Response | Provide Valid Product Rule ID. | 400 | | R0009112 | Product Rule Status, if present, must be A or I | POST, PUT | Acknowledgement Error Response | Product Rule Status must be 'A' or 'I' | 400 | | R0009113 | Product Rule Status, if present, must be alpha | POST, PUT | Acknowledgement Error Response | Product Rule Status must be alphabet only | 400 | | R0009114 | Day of month start, if present, must be numeric | POST, PUT | Acknowledgement Error Response | Day of month start must be alphabet only | 400 | | R0009115 | Day of month start, if present, must be within the valid range | POST, PUT | Acknowledgement Error Response | Day of month starts, if present must be within the valid alphabet only | 400 | | R0009116 | Day of month end, if present, must be numeric | POST, PUT | Acknowledgement Error Response | Day of month end must be alphabet only | 400 | | R0009117 | Day of month end, if present, must be within the valid range | POST, PUT | Acknowledgement Error Response | Day of month end if present must be within the valid alphabet only | 400 | | R0009142 | Geography, if present, must be alpha or spaces | POST, PUT | Acknowledgement Error Response | Geography must be alpha or spaces. | 400 | | R0009143 | Geography, if present, must not exceed 15 positions | POST, PUT | Acknowledgement Error Response | Geography must not exceed 15 positions. | 400 | | R0009144 | Transaction Channel, if present, must be alpha | POST, PUT | Acknowledgement Error Response | Transaction Channel must be alpha. | 400 | | R0009145 | Transaction Channel, if present, must not exceed 60 positions | POST, PUT | Acknowledgement Error Response | Transaction Channel must not exceed 15 positions. | 400 | | R0009146 | Householding ID, when present, must be alphanumeric or valid special characters | POST, PUT | Acknowledgement Error Response | Householding ID must be alphanumeric or must contain valid special characters. | 400 | | R0009147 | Householding ID, when present, must not exceed 25 positions | POST, PUT | Acknowledgement Error Response | Householding ID must not exceed 25 positions. | 400 | | R0009148 | Householding ID, when present, must not have leading spaces | POST, PUT | Acknowledgement Error Response | Householding ID must not have leading spaces. | 400 | | R0009074 | Acquiring Institution ID Code, if present, must not exceed 11 positions | POST, PUT | Acknowledgement Error Response | Acquiring Institution ID Code, if present, must not exceed 11 positions | 400 | | R0009055 | Acquiring Institution ID Code must be numeric | POST, PUT | Acknowledgement Error Response | Acquiring Institution ID Code must be numeric | 400 | | R0009070 | Card Acceptor ID Code, if present, must not exceed 15 positions | POST, PUT | Acknowledgement Error Response | Card Acceptor ID Code, if present, must not exceed 15 positions | 400 | | R0009071 | Card Acceptor ID Code must be alphanumeric or valid special characters (no spaces) | POST, PUT | Acknowledgement Error Response | Card Acceptor ID Code must be alphanumeric or contain valid special characters and may not contain spaces | 400 | | R0009056 | Mastercard Assigned ID, if present, must not exceed 8 positions | POST, PUT | Acknowledgement Error Response | Mastercard Assigned ID, if present, must not exceed 8 positions | 400 | | R0009057 | Mastercard Assigned ID must be alphanumeric | POST, PUT | Acknowledgement Error Response | Mastercard Assigned ID must be alphanumeric or contain valid special characters and may not contain spaces | 400 | | R0009058 | POS Country Code, if present, length must equal 3 | POST, PUT | Acknowledgement Error Response | POS Country Code, if present, must not exceed 3 positions | 400 | | R0009059 | POS Country Code must be numeric | POST, PUT | Acknowledgement Error Response | POS Country Code must be alphanumeric or contain valid special characters and may not contain spaces | 400 | | R0009072 | Sub Merchant ID, if present, must not exceed 15 positions | POST, PUT | Acknowledgement Error Response | Sub Merchant ID, if present, must not exceed 15 positions | 400 | | R0009073 | Sub Merchant ID must be alphanumeric or valid special characters (no spaces) | POST, PUT | Acknowledgement Error Response | Sub Merchant ID must be alphanumeric or contain valid special characters and may not contain spaces | 400 | | R0009060 | Merchant Type, if present, must not exceed 4 positions | POST, PUT | Acknowledgement Error Response | Merchant Type, if present, must not exceed 4 positions | 400 | | R0009061 | Merchant Type must be numeric | POST, PUT | Acknowledgement Error Response | Merchant Type must be numeric | 400 | | R0009062 | Cardholder Transaction Type Code, if present, must not exceed 2 positions | POST, PUT | Acknowledgement Error Response | Cardholder Transaction Type Code, if present, must not exceed 2 positions | 400 | | R0009063 | Cardholder Transaction Type Code must be numeric | POST, PUT | Acknowledgement Error Response | Cardholder Transaction Type Code must be numeric | 400 | | R0009064 | Minimum Transaction Amount, if present, must not exceed 12 positions | POST, PUT | Acknowledgement Error Response | Minimum Transaction Amount, if present, must not exceed 12 positions | 400 | | R0009065 | Minimum Transaction Amount must be numeric | POST, PUT | Acknowledgement Error Response | Minimum Transaction Amount must be numeric | 400 | | R0009066 | Maximum Transaction Amount, if present, must not exceed 12 positions | POST, PUT | Acknowledgement Error Response | Maximum Transaction Amount, if present, must not exceed 12 positions | 400 | | R0009067 | Maximum Transaction Amount must be numeric | POST, PUT | Acknowledgement Error Response | Maximum Transaction Amount must be numeric | 400 | | R0009068 | Transaction Currency Code, if present, must not exceed 3 positions | POST, PUT | Acknowledgement Error Response | Transaction Currency Code, if present, must not exceed 3 positions | 400 | | R0009069 | Transaction Currency Code must be numeric | POST, PUT | Acknowledgement Error Response | Transaction Currency Code must be numeric | 400 | | **Reject Code** | **Description** | **Applicable for HTTP Endpoint** | **Message** | **Resolution Tips** | **Response Code** | |-----------------|------------------------------------------------------------------------------------------------|----------------------------------|--------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------| | R0000370 | Request ID, provided in the header, is required and must be present | POST, PUT, DELETE | Acknowledgement Error Response | Check if request ID is provided in the header, if not then add unique request ID. | 400 | | R0000376 | Request ID must be alphanumeric or contain valid special characters and may not contain spaces | POST, PUT, DELETE | Acknowledgement Error Response | The Request ID should be revalidated as per the specification. | 400 | | R0000377 | Request ID must not exceed 255 positions | POST, PUT, DELETE | Acknowledgement Error Response | The Request ID length should be revalidated and corrected as per the specification. | 400 | | R0000371 | Request ID is a duplicate and used on a previous submission | POST, PUT, DELETE | Acknowledgement Error Response | Generate new request ID and provide in header. Previous request ID should not be used. | 400 | | R0000373 | API request has incorrect JSON format (invalid JSON schema) | POST, PUT, DELETE | Acknowledgement Error Response | Check the JSON format of the request and correct it | 400 | | R0000379 | Duplicate field in JSON request | POST, PUT, DELETE | Acknowledgement Error Response | *Code collision: in the PDF catalog R0000379 = "Account Identifier Expiration Date should be in the MMYY format"; the processor uses R0000379 for a duplicate JSON field. See Code Verification Notes.* | 400 | | R0000385 | Request not processed successfully due to system failure (ARE delete -\> HTTP 500) | POST, PUT, DELETE | Acknowledgement Error Response | If in recoverable field's value of error response is true, then retry request else contact to customer support team. | 500 | | R0009050 | Domain not found for a given record | POST, PUT, DELETE | Acknowledgement Error Response | Domain not found for a given record. | 408 | | R0009500 | Domain response not received (timeout; ARE delete -\> HTTP 408 PENDING) | POST, PUT, DELETE | Acknowledgement Error Response | Unable to process the request because a response from the domain was not received. | 408 | | R0009105 | Account range start must be present | POST, PUT, DELETE | Acknowledgement Error Response | Account Range Start is mandatory to provide | 400 | | R0009106 | Account range start must be numeric | POST, PUT, DELETE | Acknowledgement Error Response | Account Range End is mandatory to provide | 400 | | R0009107 | Account range start must be 13-19 positions | POST, PUT, DELETE | Acknowledgement Error Response | Account Range Start must be between 13-19 position | 400 | | R0009108 | Account range end must be present | POST, PUT, DELETE | Acknowledgement Error Response | Account Range End must be between 13-19 position | 400 | | R0009109 | Account range end must be numeric | POST, PUT, DELETE | Acknowledgement Error Response | Account Range Start must be numeric | 400 | | R0009110 | Account range end must be 13-19 positions | POST, PUT, DELETE | Acknowledgement Error Response | Account Range End must be numeric | 400 | | R0009111 | Account range end must be greater than Account range start | POST, PUT, DELETE | Acknowledgement Error Response | Account range end must be greater than Account range start. | 400 | | R0009121 | At least one Product Rule required for given request | POST, PUT | Acknowledgement Error Response | At least One Product for given alphabet only | 400 | | R0009122 | Product Rules size must not exceed the maximum allowed | POST, PUT | Acknowledgement Error Response | Product must not be alphabet only. | 400 | | R0009130 | Product Rule Id must be present | PUT, DELETE | Acknowledgement Error Response | Product Rule ID must be present. | 400 | | R0009134 | Product Rule ID is not valid (must be a valid UUID) | PUT, DELETE | Acknowledgement Error Response | Product Rule ID is not valid. | 400 | | R0009119 | Product, if present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | Product must be alphabet only | 400 | | R0009120 | Product, if present, must not exceed 4 positions | POST, PUT | Acknowledgement Error Response | Product, if must not exceed alphabet only | 400 | | R0009112 | Product Rule Status, if present, must be A or I | POST, PUT | Acknowledgement Error Response | Product Rule Status must be 'A' or 'I' | 400 | | R0009113 | Product Rule Status, if present, must be alpha | POST, PUT | Acknowledgement Error Response | Product Rule Status must be alphabet only | 400 | | R0000021 | Product Graduation Product Code, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | Product Graduation Product Code, when present, must be alphanumeric. | 400 | | R0000022 | Product Graduation Product Code must not exceed 3 positions or 3 "X" to remove | POST, PUT | Acknowledgement Error Response | Product Graduation Product Code, when present, must not exceed 3 positions or all 3 positions must contain "X" to remove the Product Graduation Product Code. | 400 | | R0000007 | Secondary PAN must be numeric | POST, PUT | Acknowledgement Error Response | PAN must be numeric | 400 | | R0000008 | Secondary PAN must be 13-19 positions | POST, PUT | Acknowledgement Error Response | PAN must be 13-19 positions. | 400 | | R0000035 | Secondary PAN failed MOD10 validation | POST, PUT | Acknowledgement Error Response | PAN failed MOD10 validation | 400 | | R0009132 | Secondary PAN Expiration Date should be in MMYY format | POST, PUT | Acknowledgement Error Response | Account Identifier Expiration Date should be in the MMYY format. | 400 | | R0009118 | Secondary PAN Status, when present, must be A or I | POST, PUT | Acknowledgement Error Response | PAN Status when present must be A or alphabet only | 400 | | R0000136 | Secondary PAN Closed Date must not exceed 8 positions | POST, PUT | Acknowledgement Error Response | PAN Closed Date must not exceed 8 positions | 400 | | R0000012 | Secondary PAN Closed Date must be valid date (YYYYMMDD) or 8 "X" to remove | POST, PUT | Acknowledgement Error Response | PAN Close Date, when present, must be in a valid date format (YYYYMMDD) and contain a valid date, or all 8 positions containing "X" to remove from the PAN on record. | 400 | | R0000014 | Secondary Replaced PAN, when present, must be alphanumeric | POST, PUT | Acknowledgement Error Response | Replaced PAN, when present, must be alphanumeric or may contain trailing spaces | 400 | | R0000015 | Secondary Replaced PAN must be 13-19 positions or 19 "X" to remove | POST, PUT | Acknowledgement Error Response | Replaced PAN, when present, must be 13-19 positions or all 19 positions containing "X" to remove the Replaced PAN | 400 | | R0000036 | Secondary Replaced PAN failed MOD10 validation | POST, PUT | Acknowledgement Error Response | Replaced PAN failed MOD10 validation | 400 | | R0000382 | Secondary Replaced PAN must not have leading or embedded spaces | POST, PUT | Acknowledgement Error Response | Replaced PAN, when present, must not have leading or embedded spaces | 400 | | R0009133 | Secondary Replaced PAN Expiration Date should be in MMYY format | POST, PUT | Acknowledgement Error Response | Replaced Account Identifier Expiration Date should be in the MMYY format. | 400 | | R0000137 | Secondary Replaced PAN Closed Date must be less than 9 positions | POST, PUT | Acknowledgement Error Response | Replaced PAN Closed Date must be less than 9 positions | 400 | | R0000017 | Secondary Replaced PAN Closed Date must be valid date (YYYYMMDD) or 8 "X" to remove | POST, PUT | Acknowledgement Error Response | Replaced PAN Closed Date, when present, must be in a valid date format (YYYYMMDD) and contain a valid date, or all 8 positions containing "X" to remove the Replaced PAN Closed Date. | 400 | | R0009074 | Acquiring Institution ID Code, if present, must not exceed 11 positions | POST, PUT | Acknowledgement Error Response | Acquiring Institution ID Code, if present, must not exceed 11 positions | 400 | | R0009055 | Acquiring Institution ID Code must be numeric | POST, PUT | Acknowledgement Error Response | Acquiring Institution ID Code must be numeric | 400 | | R0009070 | Card Acceptor ID Code, if present, must not exceed 15 positions | POST, PUT | Acknowledgement Error Response | Card Acceptor ID Code, if present, must not exceed 15 positions | 400 | | R0009071 | Card Acceptor ID Code must be alphanumeric or valid special characters (no spaces) | POST, PUT | Acknowledgement Error Response | Card Acceptor ID Code must be alphanumeric or contain valid special characters and may not contain spaces | 400 | | R0009056 | Mastercard Assigned ID, if present, must not exceed 8 positions | POST, PUT | Acknowledgement Error Response | Mastercard Assigned ID, if present, must not exceed 8 positions | 400 | | R0009057 | Mastercard Assigned ID must be alphanumeric | POST, PUT | Acknowledgement Error Response | Mastercard Assigned ID must be alphanumeric or contain valid special characters and may not contain spaces | 400 | | R0009058 | POS Country Code, if present, length must equal 3 | POST, PUT | Acknowledgement Error Response | POS Country Code, if present, must not exceed 3 positions | 400 | | R0009059 | POS Country Code must be numeric | POST, PUT | Acknowledgement Error Response | POS Country Code must be alphanumeric or contain valid special characters and may not contain spaces | 400 | | R0009072 | Sub Merchant ID, if present, must not exceed 15 positions | POST, PUT | Acknowledgement Error Response | Sub Merchant ID, if present, must not exceed 15 positions | 400 | | R0009073 | Sub Merchant ID must be alphanumeric or valid special characters (no spaces) | POST, PUT | Acknowledgement Error Response | Sub Merchant ID must be alphanumeric or contain valid special characters and may not contain spaces | 400 | | R0009060 | Merchant Type, if present, must not exceed 4 positions | POST, PUT | Acknowledgement Error Response | Merchant Type, if present, must not exceed 4 positions | 400 | | R0009061 | Merchant Type must be numeric | POST, PUT | Acknowledgement Error Response | Merchant Type must be numeric | 400 | | R0009062 | Cardholder Transaction Type Code, if present, must not exceed 2 positions | POST, PUT | Acknowledgement Error Response | Cardholder Transaction Type Code, if present, must not exceed 2 positions | 400 | | R0009063 | Cardholder Transaction Type Code must be numeric | POST, PUT | Acknowledgement Error Response | Cardholder Transaction Type Code must be numeric | 400 | | R0009064 | Minimum Transaction Amount, if present, must not exceed 12 positions | POST, PUT | Acknowledgement Error Response | Minimum Transaction Amount, if present, must not exceed 12 positions | 400 | | R0009065 | Minimum Transaction Amount must be numeric | POST, PUT | Acknowledgement Error Response | Minimum Transaction Amount must be numeric | 400 | | R0009066 | Maximum Transaction Amount, if present, must not exceed 12 positions | POST, PUT | Acknowledgement Error Response | Maximum Transaction Amount, if present, must not exceed 12 positions | 400 | | R0009067 | Maximum Transaction Amount must be numeric | POST, PUT | Acknowledgement Error Response | Maximum Transaction Amount must be numeric | 400 | | R0009068 | Transaction Currency Code, if present, must not exceed 3 positions | POST, PUT | Acknowledgement Error Response | Transaction Currency Code, if present, must not exceed 3 positions | 400 | | R0009069 | Transaction Currency Code must be numeric | POST, PUT | Acknowledgement Error Response | Transaction Currency Code must be numeric | 400 | ## Next Steps {#next-steps} * Refer [Test scenarios](https://developer.mastercard.com/account-catalog-services/documentation/testing/index.md) for request scenarios. * Consult the [API Reference](https://developer.mastercard.com/account-catalog-services/documentation/api-reference/index.md) for complete endpoint specifications, request and response schemas, and environment URLs. * If you run into issues, visit [Support](https://developer.mastercard.com/account-catalog-services/documentation/support/index.md) for FAQs and troubleshooting guidance.