> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kryptopay.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> How to handle KryptoPay API and checkout errors.

KryptoPay returns structured JSON errors with stable `error` codes.

## Common categories

* Auth errors: missing/invalid API key
* Validation errors: invalid body fields
* State errors: expired intent
* Internal errors: temporary server failures

## Handling strategy

* Do not retry invalid auth/validation requests.
* Retry network and transient server failures with backoff.
* Log request context and error code for support.
* Show user-safe messages in UI and keep internal details in logs.

## Example

```json theme={null}
{
  "error": "invalid_body"
}
```

Error payload shape can vary by endpoint, but `error` remains the primary machine-readable field.