--- title: Payment Form Error Messages slug: payment-form-error-messages docTags: createdAt: 2024-08-28T12:20:55.537Z --- # Displaying Payment Form Error Messages The Web SDK is designed to provide feedback quickly and clearly to the consumer. To display payment form error messages: 1. Add a div with the id **judopay-errors** on your page, ideally below the iframe: `
;` The table below displays all errors that can be returned: | **ID** | **Error String** | | ------ | ----------------------------------------------------------- | | 0 | Card number can only contain numbers | | 1 | Card number not valid | | 2 | Card type not recognised, please recheck your number | | 3 | {1} is not supported | | 4 | Card number required | | 5 | Card is expired | | 6 | Card expiry date is not valid | | 7 | Expiry date required | | 8 | {0} code too short for {1} card | | 9 | {0} code too long for {1} card | | 10 | {0} code can only contain numbers | | 11 | {0} code required for {1} card | | 12 | Post/Zip code is invalid | | 13 | Sorry, an error has occurred, you have not been charged. | | 14 | Cardholder Name is required | | 15 | Cardholder Name can't be less than 4 characters | | 16 | Cardholder Name can't contain numbers or special characters | For error strings containing** {0}** and** {1}**, these will be changed into values depending on the current state of the iframe form. For example: - \{**0**} will change to the card verification code acronym. This is named differently depending on the card type (e.g. CVC, CVV). - \{**1**} will refer to the detected card type, for example Visa, Mastercard, Diners Club International or Discover. If the iframe has detected a Visa number, the following error message transform would occur: `{0} code too long for {1} card" -> "CVC code to long for Visa card` A similar error with an American Express card, the message would appear as: `CID code too long for American Express card"` *** ## Web SDK Error Responses There are 2 possible error formats: 1. Error responses from our **Transaction API** (which the Web SDK formats and returns). These are caused by the **transaction **itself, for example: 1. Incorrect payment credentials 2. Failure of 3D Secure 2 For more information on this type of error, see [Enhanced Error Messaging for Web SDK](docId\:qfxaWPAQl_-2EVfP8y94d). 2. Errors thrown by the **Web SDK** code. Examples of causes can be: 1. Scripts failing to load 2. Closing of a modal 3. Time-outs For more information on this type of error, see [here](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error). *** ### Enhanced Error Messaging for Web SDK For Web SDK Version **0.0.29** (or higher), the error response object has the following additional fields describing the error: - name - status - judoDetails :::hint{type="info"} Not all errors returned from the Web SDK will have the new format described below. This only refers to errors that originated from our Transaction API (previous to version 0.0.29) having the following interface: **\{message: string}**. ::: **Error Object Response Fields** | **Field** | **Description** | | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `message`
String | A text description of the error. | | `name`
String | Represents a name for the type of error. | | `status`
Number | A HTTP response status code. | | `judoDetails`
Object
| Object giving additional context to the error.
For further details on the interface of the judoDetails object, including examples, see [JudoDetails Object](docId\:qfxaWPAQl_-2EVfP8y94d).
This field is optional. | *** **Examples of the Enhanced Error Response** The enhanced error response provides an error object with additional fields to increase the description of the error, for example: :::::Tabs ::::Tab{title="Cause: Amount = 0.00"} **Enhanced Error Response:** :::BlockQuote \{ message: 'Request failed with status code 400', name: "Error", status: 400, judoDetails: \{ category: 2, code: 1, details: \[\{ code: 4, fieldName: 'Amount', message: 'Sorry, but the amount specified must be greater than "0".', detail: "Sorry, we're currently unable to process this request."}], message: "Sorry, we're unable to process your request. Please check your details and try again." } } ::: *** :::: ::::Tab{title="Cause: Card Authentication Fails"} **Enhanced Error Response:** :::BlockQuote \{ message: 'Request failed with status code 400', name: "Error", status: 400, judoDetails: \{ category: 4, code: 158, message: "Sorry, but your card authentication has failed." } } ::: :::: ::::: ### JudoDetails Object The **judoDetails **object aims to provide additional context around the error. See below for further information on the optional **judoDetails **object that is now included in the error response: ### JudoDetails Interface | **Field** | **Description** | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `message`
String | A text description of the error. | | `code`
Number | A static numeric code associated with the specific error. | | `category`
Number
| The type of error:
1 - RequestError
2 - ModelError
3 - ConfigError
4 - DuplicationError / ProcessingError
5 - ExceptionError | | `details`
Object
| Object giving additional context to the error.
For examples on what this object may look like, see [judoDetails Examples](docId\:qfxaWPAQl_-2EVfP8y94d).
This field is optional.
**For ModelError**:
- Array of FieldErrors describing one or more attributes.
**For DuplicationError**:
- Provides the receiptId and url of the duplicate transaction. | ### JudoDetails Examples :::::Tabs ::::Tab{title="RequestError Example"} **Example Category 1:** :::BlockQuote \{ message: "Sorry, but we were unable to authenticate your request. Please check your details and try again.", code: 403, category: 1 } ::: :::BlockQuote \{ message: "We've been unable to decrypt the supplied Encrypted payload. Please ensure the message has not been modified.", code: 150, category: 1 } ::: :::: ::::Tab{title="ModelError Example"} Response will contain one or more FieldErrors in the details block. **Example Category 2**: :::BlockQuote \{ details: \[ \{ code: 50, fieldName: "PostCode", message: "Please supply the postcode" }, \{ code: 33, fieldName: "Cv2", message: "Sorry, the security code entered is invalid. Please check your details and try again." } ], message: "Sorry, we're unable to process your request. Please check your details and try again.", code: 1, category: 2 } ::: :::: ::::Tab{title="ConfigError Example"} **Example Category 3**: :::BlockQuote \{ message: "Sorry, but the amount you're trying to collect is greater than the pre-auth.", code: 46, category: 3 } ::: :::BlockQuote \{ message: "Sorry, but the amount you're trying to refund is greater than the original transaction.", code: 49, category: 3 } ::: :::: ::::Tab{title="DuplicationError Example"} **Example Category 4**: :::BlockQuote \{ details: \{ receiptId: 717774858666278912, url\:https\://gw1.karatepaysandbox.com/transactions/717774858666278912" }, message: "Sorry, this payment has been stopped as it is a duplicate transaction.", code: 86, category: 4 } ::: :::: ::::Tab{title="ProcessingError Example"} **Example Category 4**: :::BlockQuote \{ message: "Sorry, but your card authentication attempt was rejected by the issuer.", code: 159, category: 4 } ::: :::: ::::Tab{title="ExceptionError Example"} **Example Category 5**: :::BlockQuote \{ message: "The content-type was not specified or is unsupported for the request made to the Judopay API. Currently supported content-type is limited to application/json.", code: 0, category: 5 } ::: :::: :::::