> ## 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

> Error class containing payment and SDK error details

> [!WARNING]
>
> Primer Checkout Android SDK is currently in **beta** (v3.0.0-beta.8).
> The API is subject to change before the stable release.

Error class carried by [`PrimerCheckoutState.Failure`](https://primer.io/docs/sdk/android-checkout/v3.0.0-beta/api/primer-checkout-state). Contains error details and a diagnostics ID for Primer support.

## Definition

```kotlin theme={"dark"}
class PrimerError {
    val errorId: String
    val description: String
    val errorCode: String?
    val diagnosticsId: String
    val recoverySuggestion: String?
}
```

## Properties

| Property | Type | Description |
| - | - | - |
| `errorId` | `String` | Unique error identifier for programmatic handling |
| `description` | `String` | Human-readable error message (suitable for logging) |
| `errorCode` | `String?` | Specific failure reason (e.g., `"card_declined"`, `"insufficient_funds"`). `null` for non-payment errors. |
| `diagnosticsId` | `String` | Unique diagnostics ID. Provide to Primer support when investigating issues. |
| `recoverySuggestion` | `String?` | Suggested recovery action. `null` when no recovery applies. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.