Centinel API Error Codes

Centinel API error codes are generated on the server side. These errors will return back a response JWT from Centinel API and you can validate the response. Centinel API errors can be identified by being between 1000 - 9999.

Error Code	Error Description	Description
1000	Error processing request. We have encountered an unexpected error.	A general error has occurred.
1001	Not authorized to access this request.	The API Key used does not have the proper permissions to access the requested feature.
1003	Invalid request. Please check your formatting.	Centinel API was unable to parse the request JWT. This can often indicate a malformed request JWT.
1010	Invalid Signature. Your request contains an invalid signature.	The request JWT failed signature validation. This can indicate incorrect or malformed Api Key values were used when signing the JWT.
1011	Signature expired. Your signature is not within the acceptable time frame.	The request JWT has expired. Default TTL (Time To Live) for a JWT is 4hrs unless a lower value is passed in the 'exp' claim of the request JWT.
1020	Invalid JWT.
1010	Error Creating Jwe
2001	Null response from service
2002	Errors in one or more service(s)	Returned when multiple calls to third party systems are made
4000	Validation Error	Additional error details will be returned back in the error description field. Depending on the error, details are either appended to the description or replace the description.
4001	Invalid payment type submitted
5001	Invalid response from third party
9000	Error in service	Generic third party error number, third party errors are mapped to this and start with 9
9999	System Error

Songbird Error Codes

Songbird errors are errors generated within Songbird that will not have any JWT's attached to them. These errors indicate the JavaScript client encountered some error during execution. Songbird errors can be identified by being in the 10,000 range.

Error Code	Error Description	Description
10001	Midas Connection Error on Init.	Timeout when sending an /Init message
10002	Midas Connection Error on Start.	Timeout when sending an /Start message
10003	Midas Connection Error on Validate.	Timeout when sending an /Validate message. Although this code exists we do not yet have a flow where a validate message is sent to Midas. This error should not yet be triggered
10004	A general error has occurred.	Catch all error
10005	No JWT found. Please check your setup configuration.	Songbird was started without a request jwt.
10006		This is a general configuration error. The description is populated by the specific configuration error that caused the error.
10007	Centinel API connection error on Confirm.	Timeout when sending an /Confirm message
10008	No Cardinal Response JWT found. Please check your setup configuration.	Songbird was initialized without a merchant JWT.
10009	Centinel API connection error on Continue.	Timeout when sending an /Continue message
10010	Response malformed, unable to parse.	The response JWT was
10011	Canceled by user	The user has canceled the transaction. This is generally found in alternative payments that supply a cancel button on the payment brand side.
10012		An error occurred with hosted fields. The description will contain what specifics on what was encountered