> ## Documentation Index
> Fetch the complete documentation index at: https://primer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# PrimerError
```kotlin KOTLIN theme={"dark"}
sealed class PrimerError {
abstract val errorId: String
abstract val description: String
abstract val errorCode: String?
abstract val diagnosticsId: String
abstract val recoverySuggestion: String?
}
```
## Properties
A unique error identifier.
A unique error code.
A error description.
A recovery suggestion for the given error. In case it's present, use it to try
to recover from error.
A unique diagnostics id for the given error.
List of the Component validation errors can be found [here](/sdk/android/v2.x.x/common-objects/PrimerValidationError).
List of the Raw Data Manager validation errors can be found [here](/sdk/android/v2.x.x/common-objects/PrimerInputValidationError).
## Exposed Error IDs and Error Codes
### SDK Configuration Errors
| Error ID | Description | Recovery Suggestion |
| ------------------------ | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `missing-configuration` | Returned when the internal SDK configuration is not present. | Check if you have an active internet connection. |
| `invalid-client-token` | Returned when the provided client token does not have a valid JWT format. | Ensure that the client token fetched from your backend is a valid client token (i.e. not null, not blank, is valid JWT and it comes from Primer) |
| `expired-client-token` | Returned when the provided client token has expired. | Avoid storing client tokens locally. Fetch a new client token to provide on when starting Primer. |
| `missing-sdk-dependency` | Returned when an SDK dependency is missing for a payment method type. | Follow the integration guide and include missing dependency. |
### Connectivity Errors
| Error ID | Description | Recovery Suggestion |
| ------------- | ------------------------------- | --------------------------------------------- |
| `bad-network` | Indicates a connectivity issue. | Check your internet connection and try again. |
### HTTP Errors
| Error ID | Description | Recovery Suggestion |
| -------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| `unauthorized` | Indicates that the SDK's request lacks valid authentication credentials (HTTP 401). | Check the server's response to debug this error further. |
| `client-error` | Indicates an error caused by the SDK's request (HTTP 4xx). | Check the server's response to debug this error further. |
| `server-error` | Indicates an error caused by the server while processing the SDK's request (HTTP 5xx). | Check the server's response to debug this error further. |
### Payment Errors
| Error ID | Description | Recovery Suggestion |
| -------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------- |
| `payment-failed` | Returned when processing a payment has failed. | Contact Primer and provide us with diagnostics id. |
| `failed-to-create-payment` | Returned when there is a failure in the internal SDK create payment call. | Contact Primer and provide us with diagnostics id. |
| `failed-to-resume-payment` | Returned when there is a failure in the internal SDK resume payment call. | Contact Primer and provide us with diagnostics id. |
| `payment-cancelled` | Returned when the payment was cancelled by the user. | N/A |
### Headless Universal Checkout Specific Errors
| Error ID | Description | Recovery Suggestion |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `huc-initialization-failed` | Returned when Headless Universal Checkout failed to initialize during the [start](/sdk/android/v2.x.x/primer-headless-checkout/methods/start) call. | Ensure you are calling `start` method before calling this method. |
| `invalid-raw-type-data` | Returned when the wrong data type is being passed to the [setRawData](/sdk/android/v2.x.x/primer-headless-checkout/raw-data-manager/setRawData) method. | Verify the data type being passed and correct it. |
| `invalid-raw-data` | Returned when the [submit](/sdk/android/v2.x.x/primer-headless-checkout/raw-data-manager/submit) method was called without a prior call to the [setRawData](/sdk/android/v2.x.x/primer-headless-checkout/raw-data-manager/setRawData) method. | Ensure `setRawData` is called with valid data before calling `submit`. |
### Payment Method Errors
#### Google Pay
| Error ID | Description | Recovery Suggestion |
| --------------------------------- | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------- |
| `google-pay-internal` | Returned when there is an internal error returned by Google Pay. | Contact Primer and provide us with diagnostics id. |
| `shipping-address-unserviceable ` | Returned when the selected shipping method cannot be used with the selected address. | Display the Google Pay sheet again with appropriate shipping method. |
#### Klarna
| Error ID | Description | Recovery Suggestion |
| -------------------------- | -------------------------------------------------------------------- | ------------------- |
| `klarna-user-not-approved` | Returned when the user declined the Klarna transaction. | N/A |
| `klarna-sdk-error` | Returned when there is an internal error returned by the Klarna SDK. | N/A |
#### iPay88
| Error ID | Description | Recovery Suggestion |
| --------------------------- | ----------------------------------------------------------------------- | --------------------------------------- |
| `payment-failed` | Returned when processing a payment has failed. | N/A |
| `ipay-sdk-connection-error` | Returned when there is an internal connection error returned by iPay88. | Check the network connection and retry. |
#### nol Pay
| Error ID | Description | Recovery Suggestion |
| ------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
| `nol-pay-sdk-error` | Returned when there is an error returned by nol Pay. Errors can be distinguished by `errorCode`: | Specific recovery suggestions based on the `errorCode`: |
| | - `A3300`: Failed to init Transit SDK | - `A3300`: Ensure the Transit SDK is correctly initialized and try again. |
| | - `A3301`: Error on request parameter | - `A3301`: Contact Primer and provide us with diagnostics id. |
| | - `A3302`: Network error | - `A3302`: Check network connection and retry. |
| | - `A3304`: Failed to handle response payload | - `A3304`: Contact Primer and provide us with diagnostics id. |
| | - `A3305`: API call failed | - `A3305`: Contact Primer and provide us with diagnostics id. |
| | - `A3310`: Mobile phone does not support NFC | - `A3310`: Ensure the mobile phone supports NFC and retry. |
| | - `A3311`: NFC disabled on mobile phone | - `A3311`: Enable NFC on the mobile phone and retry. |
| | - `A3312`: Invalid NFC Tag | - `A3312`: Verify the NFC tag and retry. |
| | - `A3313`: NFC disconnected, user should hold Nol card until scanning finishes | - `A3313`: Hold the Nol card steady until scanning finishes. |
| | - `A3314`: NFC Command error | - `A3314`: Contact Primer and provide us with diagnostics id. |
#### Session Create Error
| Error ID | Description | Recovery Suggestion |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| `failed-to-create-session` | Returned when the Universal Checkout failed to create a session with 3rd party sides (e.g., Klarna, PayPal, etc.). | Ensure that the Payment method is configured correctly on the dashboard ([https://dashboard.primer.io/](https://dashboard.primer.io/)) |
### General Errors
| Error ID | Description | Recovery Suggestion |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `invalid-value` | Returned when the required data for specific use cases has an invalid format or is missing. | Verify the data format and ensure all required data is provided. |
| `invalid-client-session-value` | Returned when the required client session data for specific use cases has an invalid format or is missing. | Verify the client session data format and ensure all required data is provided when calling [Create a client session](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session) API call. |
| `failed-to-update-client-session` | Returned when the client session fails to update (e.g., selecting a payment method due to a surcharge being present, updating the billing address captured from Google Pay). | Check the session update parameters and retry. |
| `unknown-error` | Returned when the SDK catches an unmapped `Exception`. | Contact Primer and provide us with diagnostics id. |