optimization protection

Notifications response codes

Error codes help you to debug to issues that occur as a result of sending badly formatted requests. The responseMessage is a short string that provides a brief explanation. The tables below 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: The term "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.

Tip

The responseStatus, responseCode, and responseMessage fields are required.

Successful responses (200-299)

In general, a 200 status code indicates that a request has successfully processed.

Tip

To determine whether a transaction was approved or declined, you will need to review the responseStatus field to identify whether or not the issuer has approved the transaction (SUCCESS or DENIED).

HTTP 2XX status codes
Scenario	HTTP status	responseStatus	responseCode	responseMessage
Successful subscription update	200	SUCCESS	ACCEPTED	Request accepted
Get subscription by merchant ID was successful	200	SUCCESS	ACCEPTED	Request accepted
Get subscription ID was successful	200	SUCCESS	ACCEPTED	Request accepted
Get subscription by ID was successful	200	SUCCESS	ACCEPTED	Request accepted
Successful subscription deletion	200	SUCCESS	ACCEPTED	Request accepted
Get notification by notification ID was successful	200	SUCCESS	ACCEPTED	Request accepted
Successful subscription creation	201	SUCCESS	ACCEPTED	Request accepted

Client error responses (400-499)

A 4XX status code indicates that an error has occurred during a 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 resubmit the request.

HTTP 4XX status codes
Scenario	HTTP status	responseStatus	responseCode	responseMessage
Request fields are missing or provided format is incorrect	400	ERROR	VALIDATION_ERROR	Request contains validation error
Authentication failure	401	ERROR	UNAUTHORIZED	Authorization credentials are missing or invalid
Authorization failure	403	ERROR	UNAUTHORIZED	Authorization credentials are missing or invalid
Subscription not found for provided subscription ID	404	ERROR	VALIDATION_ERROR	Subscription not found
Notification not found for provided notification ID	404	ERROR	VALIDATION_ERROR	Notification not found

Server error responses (500-599)

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

HTTP 5XX status codes
Scenario	HTTP status	responseStatus	responseCode	responseMessage
Internal processing error	500	ERROR	SERVER_ERROR	Server error, please retry
A decryption failure has occurred	500	ERROR	SERVER_ERROR	Failed to decrypt
Unknown error has occurred	503	ERROR	HOST_ERROR	An unknown error has occurred
Gateway timeout	504	ERROR	TIMEOUT	Request timeout