# Widget Error Codes
source: https://developer.mastercard.com/eligibility-api/documentation/code-and-formats/widget-error-codes/index.md

## Widget Error Codes {#widget-error-codes}

Error codes specific to Widget API are listed below.

| **Error/Reason Code** |                                                 **Scenario**                                                 |                                          **How to Resolve**                                          |
|-----------------------|--------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
| 40000001              | The card number entered is either missing, incomplete, or contains invalid characters.                       | Provide a valid card number with 16 digits                                                           |
| 40303002              | The authentication token provided in the request header has expired or is malformed.                         | Generate a new token and retry the request                                                           |
| 40300102              | The token authentication process failed due to invalid credentials or token mismatch.                        | Verify token generation process and provide a valid token                                            |
| 50000001              | An internal server error occurred while fetching benefits information from the backend system.               | Retry the request after a few moments. If the issue persists, contact support                        |
| 40301002              | The authenticated user or application does not have sufficient permissions to access the requested resource. | Verify your access permissions and domain with your administrator                                    |
| 50000002              | The system was unable to retrieve card details, likely due to an unrecognized or invalid card number.        | Verify the card number is correct and belongs to a supported card network                            |
| 40300104              | The token provided in the request could not be parsed, possibly due to corruption or expiration.             | Generate a new token and retry the request                                                           |
| 40001001              | The request was sent without an authorization token in the header, so authentication could not be performed. | Include a valid authorization token in the request header when invoking the initialization function. |
| 50003001              | The backend system encountered an unexpected error while generating a new authentication token.              | Retry the request after a few moments. If the issue persists, contact support                        |
| CONFIG-NOT-FOUND      | The system could not find configuration data for the specified consumer, which may be missing or incorrect.  | Verify the configuration key is correct and if still issue still persist contact support             |

### No Benefits Found {#no-benefits-found}

If there are no benefits found that meet the request criteria the HTTP Status code will be **200 OK** and the return body will have the following structure:

```json
{
  "benefitInfoList": [],
  "products": [
    {
      "productCd": "MCB",
      "productGrpCd": "2223",
      "productGrpName": "World",
      "productName": "Single Product"
    }
  ],
  "issuerDetails": {
    "externalReference": "USA Reference",
    "parentICACode": "8996",
    "icaBusinessName": "Skyline Distributors",
    "icaCode": "8996",
    "icaCountry": "USA",
    "icaLegalName": "Skyline Distributors",
    "icaRegion": "US",
    "icaState": "Indiova"
  },
  "responseCode": "200",
  "responseMessage": "Benefits data not Found."
}
```

### UI Error Messages {#ui-error-messages}

1. **Client-Side Validation Error** : When an invalid, empty, or incorrectly formatted card number is submitted, the widget triggers a configurable validation error with the default message **"Please enter a valid card number"** . This error message can be programmatically customized via the `errorMessage` configuration property within the submit button object.

2. **Real-Time PAN Validation** : When an invalid or incorrectly formatted card number is entered during input (real-time validation), the widget displays a configurable validation error with the default message **"Please enter a valid card number"** . This error message can be programmatically customized via the `errorMessage` configuration property within the pan input object.

3. **Widget Initialization Token Validation** : When the widget loads and the `/initialize` endpoint call fails due to an invalid or expired token, all widget functionality is disabled and a tooltip displays the default message **"Please refresh the page to reinitiate the widget."** This error message can be programmatically customized via the `message` configuration property within the tooltip configuration object.

**Note** : The widget error messages can be customized programmatically using the configuration properties mentioned above. For more details, refer to the [Widget Customization](https://developer.mastercard.com/eligibility-api/documentation/tutorials-and-guides/widget-tutorial/widget-customization/index.md) guide.