Menu

Errors

Copied!
{
    "httpStatusCode":400,
    "customCode":"BAD_REQUEST",
    "message":"Some request parameters are invalid",
    "description":"Bad request, please check your request",
    "errorHelpUrl":null,
    "originalRequest":{... original request json object ...}
}

Custom Codes Used

Worldpay uses the following custom codes (corresponding HTTP status code between brackets)

BAD_REQUEST (400): If JSON supplied is not valid or if JSON supplied is valid but the request is not complete or has errors, e.g a blank password. The message will describe what the issue is.

TKN_EXPIRED (400): If the token used has expired. Non-reusable tokens expire after use in an order request.

ERROR_PARSING_JSON (400): If schema is not valid and we can't parse the JSON.

INVALID_PAYMENT_DETAILS (400): When a card type is unsupported such as Diners.

UNAUTHORIZED (401): If the Client Key or Service Key you are using is invalid. This may occur if you have reset your keys.

UNAUTHORIZED (401): If you did not send us the Service Key.

UNAUTHORIZED (401): If the key you are using has expired or has been disabled.

MERCHANT_DISABLED (401): If your account is no longer active.

UNAUTHORIZED (401): If you send us the Test Service Key when having used the Live Client Key in Worldpay.js or the other way around.

RECURRING_BILLING_NOT_ENABLED (400): Recurring billing is not enabled on your account, please enable before making recurring orders.

RECURRING_BILLING_NOT_SETUP (401): We are in process of setting up recurring billing on your account, please try again later.

TKN_NOT_FOUND (404): If the token used could not be found in our database.

ORDER_NOT_FOUND (404): If the token used could not be found in our database.

TOKEN_CONFLICT (409): Token is used by another Order Request.

MEDIA_TYPE_NOT_SUPPORTED (415): If media type is other than "application/json".

INTERNAL_SERVER_ERROR (500): Something went wrong on our side. Please let us know if this persists.

UNEXPECTED_ERROR (500): Likewise, something went wrong on our side. Please let us know if this persists.

API_ERROR (500): Likewise, something went wrong on our side. Please let us know if this persists.

You will find the list of HTTP status codes used on the right.

httpStatusCodeInteger - The HTTP status code. You can find the complete list of httpStatusCodes used on the right hand side
customCodeString - Will describe the context of the error. You can find the complete list of customCodes used on the right hand side
messageString - A description of the error that occurred
descriptionString - Support information with a description of what to do next
errorHelpUrlString - Link to website with more information about this error. This is an optional field and may not always be sent
originalRequestJSON - Original Request object that created this error