Key Management response codes

Error codes help you debug issues that occur as a result of sending badly formatted requests. The responseMessage is a short string that provides a brief explanation. The following tables list the available reason codes, as well as their possible causes.

The following fields are in the body of the response:

• responseStatus: Valid values include: SUCCESS, DENIED, or ERROR. SUCCESS means the request was approved by the issuer or completed successfully. ERROR is only returned for 4XX or 5XX responses.
• responseCode: This field contains a shorter description of the processing result. For 200 responses, this may be displayed to the consumer.
• responseMessage: This field contains a longer, more descriptive message. These messages are not intended to be displayed to the consumer.
• hostMessage: Host refers to the system from which J.P. Morgan has received a response. The hostMessage is mapped to J.P. Morgan’s response fields, but the unaltered message is returned, if received. For 5XX responses, the presence of this field indicates where the error exists.

Successful responses (200 – 299)

In general, a 200 status code indicates that a request has successfully processed, but does not necessarily mean that the issuer has approved the transaction.

Client error responses (400 – 499)

A 4XX status code indicates that an error has occurred during request, and provides a list of specific codes. Additional fields are provided in the body of the response to help identify the error. Address the problem, and then resubmit the request.

Server error responses (500 – 599)

A 5XX status code indicates that an error has occurred within the J.P. Morgan (or acquirer) environment during a request. Additional fields are provided in the body of the response to identify the error.