{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Worldpay Error Responses | Worldpay Developer","description":"Worldpay for Developers - docs, code examples, resources and tools. Everything you need to build your omnichannel payment solution.","siteUrl":"https://docs.worldpay.com/access","image":"/access/assets/worldpay-logo-light.21b7daf79984773a9fcd7d4fbcb07ae5289dfffd6023c4c3dca720c7058e53dc.33f780a6.svg","keywords":"documentation, api, openapi, sdks, developer, payments, json, payouts, 3ds","jsonLd":{"@context":"https://schema.org","@type":"Organization","url":"https://docs.worldpay.com/access","name":"Worldpay"},"meta":[{"name":"google-site-verification","content":"zjziIKaP3ImsqsfhYnEBnq1R85UabiSwl7HTXuwtZuo"},{"name":"doc_product","content":"Access"},{"name":"doc_category","content":"Documentation"}],"llmstxt":{"hide":false,"sections":[{"title":"Payments API","description":"Payment orchestration API combining fraud assessment, 3ds authentication, SCA exemptions, Worldpay Token creation and a card or wallet based payment.","includeFiles":["products/payments/@20240601/**/*"],"excludeFiles":[]},{"title":"Payment Queries API","description":"Querying your payments data, based on a variety of parameters.","includeFiles":["products/payment-queries/@v1/**/*"],"excludeFiles":[]},{"title":"Card BIN Data API","description":"Provides detailed information about a card.","includeFiles":["products/card-bin/@v1/**/*"],"excludeFiles":[]},{"title":"3DS Authentication API","description":"Request 3DS authentication to protect against fraud, be SCA compliant and to shift liability using this standalone API.","includeFiles":["products/3ds/@v3/**/*"],"excludeFiles":[]},{"title":"FraudSight API","description":"Request a risk assessment and receive a response with an outcome (e.g. lowRisk) using this standalone API.","includeFiles":["products/fraudsight/@v1/**/*"],"excludeFiles":[]},{"title":"Checkout SDK","description":"Integrate using our clientside SDKs for both web and native devices. Benefit from SAQ-A/PCI-SSF compliance.","includeFiles":["products/checkout/web/@v2/**/*","products/checkout/ios/@v4/**/*","products/checkout/android/@v4/**/*","products/checkout/react-native/@v3/**/*","products/checkout/flutter/@v1/**/*"],"excludeFiles":[]},{"title":"Tokens API","description":"Minimizes the exposure of sensitive card details and increases the security of your customer's card details.","includeFiles":["products/tokens/@v3/**/*"],"excludeFiles":[]},{"title":"Card Payments API","description":"Request a card payment using this standalone API, requires separate requests for 3DS, Fraud assessment etc.","includeFiles":["products/card-payments/@v7/**/*"],"excludeFiles":[]},{"title":"Card Verifications API","description":"Verify your customer's card to maximize your authentication rates.","includeFiles":["products/card-verifications/@v6/**/*"],"excludeFiles":[]},{"title":"Account Payouts API","description":"Send funds to your customer's bank accounts and search for payouts using parameters.","includeFiles":["products/account-payouts/@20250101/**/*"],"excludeFiles":[]},{"title":"APMs","description":"Pay using eWallets, bank transfers, direct debits, local card schemes, Postpay and eInvoice/ Buy Now Pay Later.","includeFiles":["products/apms/@20240701/**/*"],"excludeFiles":[]},{"title":"Balance API","description":"Request your account details for a single account or all accounts under an entity.","includeFiles":["products/balance/@20250101/**/*"],"excludeFiles":[]},{"title":"Card Payouts API","description":"Send funds to your customer's cards.","includeFiles":["products/card-payouts/@v4/**/*"],"excludeFiles":[]},{"title":"Events (Webhooks)","description":"Receive status updates from Access Worldpay by setting up a webhook.","includeFiles":["products/events/@v1/**/*"],"excludeFiles":[]},{"title":"FX API","description":"Manage Foreign Exchange (FX) on your payments.","includeFiles":["products/fx/@v1/**/*"],"excludeFiles":[]},{"title":"Hosted Payment Pages (HPP) API","description":"Our low-code option to take payments securely at the lowest PCI compliance level - SAQ A.","includeFiles":["products/hosted-payment-pages/@v1/**/*"],"excludeFiles":[]},{"title":"Money Transfers API","description":"Money Transfer OCTs (Original Credit Transaction) allow funds to be pushed to an eligible card in 30 minutes or less.","includeFiles":["products/money-transfers/@v1/**/*"],"excludeFiles":[]},{"title":"Parties API","description":"Create parties, manage your payout instruments and beneficial owners and carry out identity verification checks.","includeFiles":["products/parties/@20250101/**/*"],"excludeFiles":[]},{"title":"SCA Exemptions API","description":"Maximize a frictionless checkout experience by using issuer data insights to apply exemptions.","includeFiles":["products/sca-exemptions/@v1/**/*"],"excludeFiles":[]},{"title":"Split Payments API","description":"Divide funds from a single payment amongst yourself and your parties/sellers.","includeFiles":["products/split-payments/@20250625/**/*"],"excludeFiles":[]},{"title":"Statements API","description":"Retrieve your account statement and see individual entries for all credits and debits.","includeFiles":["products/statements/@20250101/**/*"],"excludeFiles":[]},{"title":"Transfers API","description":"Transfer funds from source account to target account.","includeFiles":["products/transfers/@20250101/**/*"],"excludeFiles":[]},{"title":"Verified Tokens API","description":"Verified Tokens ensures that your customer's payment details are valid and CIT compliant when creating a token.","includeFiles":["products/verified-tokens/@v3/**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"worldpay-error-responses","__idx":0},"children":["Worldpay error responses"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"http-codes","__idx":1},"children":["HTTP codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In line with our Restful ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/api-principles"},"children":["API principles"]}," Access Worldpay APIs use HTTP status codes to deliver information about errors in a standards-compliant fashion."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"status-codes-in-the-4xx-range","__idx":2},"children":["Status codes in the 4xx range"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These indicate a problem with the request which you must resolve. When you resolve the problem you can safely retry the call."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common examples of these kinds of codes are authentication errors (HTTP status code 401) or request body validation errors (HTTP status code 400)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"status-codes-in-the-5xx-range","__idx":3},"children":["Status codes in the 5xx range"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These typically indicate problems on the server side of the connection. These range from configuration problems (which could be specific to a merchant or entity) to internal network connectivity problems. They may be transient, only affecting a single call, or long-lasting, impacting every single call over a long period of time. Typically callers will not be able to resolve these issues on their own."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The most common example of 5xx errors are timeouts."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-responses","__idx":4},"children":["Error responses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Alongside a HTTP status code, Access Worldpay APIs return a standardized response body describing the error in more detail wherever feasible."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Error documents from Access Worldpay APIs follow a standardized JSON structure, which include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a top-level named error"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a descriptive error message"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an optional collection of more detailed errors, if applicable"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["any specific additional information which may help to identify the error"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the JSON Path to the field is also included with the message and name to enable you to associate an error with a specific value in the request body. This is most typical for validation errors"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error names"]}," indicate the type or class of error. Across Access APIs errors with the same name have similar causes and similar resolutions. As our API set grows, names are added or may fall out of use. We aim to use names consistently across our APIs to represent the same things. Where automated processing of an error is required the HTTP status code and top level name are the most reliable elements to base decisions on."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API reference for specific API calls details some specific error names which you can see, although the list is not exhaustive."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error messages"]}," are intended to be human readable rather than machine readable and may contain valuable contextual information about the error. They don't follow a specific format and can't be relied upon to remain stable over time."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"generic-error-format","__idx":5},"children":["Generic error format"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"errorName\": \"errorName\",\n  \"message\": \"human readable message\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A machine and human readable error type for clarity and semantic understanding of the error."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A human readable message giving a corrective action for the error. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["This is not for machine consumption"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"specific-error-formats","__idx":6},"children":["Specific error formats"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Field validation errors must also contain:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Additional field"},"children":["Additional field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jsonPath"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This field represents the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.smartbear.com/alertsite/docs/monitors/api/endpoint/jsonpath.html"},"children":["JSONPath"]}," of the element within the request body associated with the error."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"examples","__idx":7},"children":["Examples"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An example error response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"errorName\": \"bodyIsNotJson\",\n  \"message\": \"You must provide valid json in the body of the request.\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"nested-errors","__idx":8},"children":["Nested errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An example of a nested error response that includes field validation:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"errorName\": \"bodyDoesNotMatchSchema\",\n  \"message\": \"The json body provided does not match the expected schema\",\n  \"validationErrors\": [\n    {\n      \"errorName\": \"fieldMustBeNumber\",\n      \"message\": \"Field at path must be a number\",\n      \"jsonPath\": \"$.amount\"\n    },\n    {\n      \"errorName\": \"fieldIsMissing\",\n      \"message\": \"Field at path must be present\",\n      \"jsonPath\": \"$.description\"\n    },\n    {\n      \"errorName\": \"fieldHasInvalidValue\",\n      \"message\": \"Payment Instrument type must be card/wallet\",\n      \"jsonPath\": \"$.paymentInstrument.type\"\n    }\n  ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"standard-errors","__idx":9},"children":["Standard errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This list is not comprehensive but covers the major types of errors which Access services may return."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"top-level-errors","__idx":10},"children":["Top level errors"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Error name"},"children":["Error name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HTTP code"},"children":["HTTP code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Additional fields"},"children":["Additional fields"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["headerIsMissing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A header in the request is missing. This header is a mandatory element of the request. The name of the header is in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["headerName"]}," field."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["headerName"]},": String"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["headerHasInvalidValue"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400, 406, 415"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A header in the request does not contain an expected value. This header must contain one of the expected valid values."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["headerName"]},": String"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["bodyIsEmpty"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The body within the request is empty. A body is required to be non-empty."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["bodyIsNotJson"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The body within the request is not valid json. This body is required to be valid json."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["bodyDoesNotMatchSchema"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["There were field validation errors. The errors that occurred are within the validationErrors array."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["validationErrors: Array of field validation errors"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["urlContainsInvalidValue"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The URL contains a value or values that are invalid."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["validationErrors: Array of url path or query parameter validation errors."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["entityIsNotConfigured"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The provided merchant entity (while valid as input) is not configured for use."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["paymentInstrumentIsNotSupported"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment instrument (while valid as input) is not configured for the given merchant entity"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["underlyingPaymentInstrumentHasExpired"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Underlying payment instrument has expired when its details are not provided in the request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["currencyIsNotSupported"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The currency (while it is a valid currency) is not configured for use by the given merchant entity"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["merchantIsNotConfigured"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The merchant is not configured to use a particular attribute in the request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["internalErrorOccurred"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An error occurred within the service (potentially due to an interaction with a downstream service)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["serviceUnavailable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["503"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Service cannot fulfil the request even though service functions without internal errors"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"field-validation-errors","__idx":11},"children":["Field validation errors"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Error name"},"children":["Error name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldIsMissing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field is missing. This field is a mandatory element of the request body."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldMustBeString"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field is not the correct type. This field is required to be a string."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldMustBeNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field is not the correct type. This field is required to be a number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldMustBeInteger"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field is not the correct type. This field is required to be an integer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldMustBeBoolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field is not the correct type. This field is required to be a boolean."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldMustBeObject"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field is not the correct type. This field is required to be a JSON object."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldMustBeArray"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field is not the correct type. This field is required to be an array."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldIsNull"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field is null. This field is a mandatory element of the request body."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldIsEmpty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field is empty. This field is required to be non-empty."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldHasInvalidValue"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field does not contain an expected value. This field must contain one of the expected valid values."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldIsNotAllowed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field is present when it is explicitly not allowed in the request."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numberIsTooSmall"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field contains a number that is below the minimum allowed value."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numberIsTooLarge"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field contains a number that is above the maximum allowed value."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["integerIsTooSmall"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field contains an integer that is below the minimum allowed value."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["integerIsTooLarge"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field contains an integer that is above the maximum allowed value."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stringIsTooShort"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field contains a string that is below the minimum allowed length."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stringIsTooLong"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field contains a string that is above the maximum allowed length."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stringFailedRegexCheck"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field contains a string that does not match the regex expression for this field."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["panFailedLuhnCheck"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field contains a PAN that has failed the Luhn check."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dateHasInvalidFormat"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The identified field contains a date that does not match the expected date format."]}]}]}]}]}]},"headings":[{"value":"Worldpay error responses","id":"worldpay-error-responses","depth":1},{"value":"HTTP codes","id":"http-codes","depth":2},{"value":"Status codes in the 4xx range","id":"status-codes-in-the-4xx-range","depth":3},{"value":"Status codes in the 5xx range","id":"status-codes-in-the-5xx-range","depth":3},{"value":"Error responses","id":"error-responses","depth":2},{"value":"Generic error format","id":"generic-error-format","depth":2},{"value":"Specific error formats","id":"specific-error-formats","depth":2},{"value":"Examples","id":"examples","depth":2},{"value":"Nested errors","id":"nested-errors","depth":2},{"value":"Standard errors","id":"standard-errors","depth":2},{"value":"Top level errors","id":"top-level-errors","depth":3},{"value":"Field validation errors","id":"field-validation-errors","depth":3}],"frontmatter":{"seo":{"title":"Worldpay Error Responses | Worldpay Developer"},"sidebar":{"path":"../../../sidebars.yaml"}},"lastModified":"2025-09-22T09:15:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/reference/worldpay-error-responses","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}