Error Codes
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 |