> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# checkout.payment.error

Emitted when a payment errors for a checkout.

---

Use `checkout.payment.error` to run actions when a payment errors for a checkout.

This typically occurs when no payment methods are available. For example, if you open a checkout with `allowedPaymentMethods` set to `["apple-pay"]`, but the customer's device or browser doesn't support Apple Pay, this is emitted.
## Schema

```yaml
title: Checkout error
type: object
properties:
  name:
    type: string
    description: Name of this event, in the format `entity.event_type`.
  type:
    type: string
    description: Type of error which occured.
    enum:
      - front-end_error
      - api_error
    x-enum-descriptions:
      front-end_error:
        description: Typically means there's a problem with Paddle.js or your integration.
      api_error:
        description: Typically means there's a problem with the Paddle API.
  code:
    type: string
    description: Short snake case string that describes this error. Use to search the error reference.
  detail:
    type: string
    description: Some information about what went wrong as a human-readable string.
  documentation_url:
    type: string
    description: Link to a page in the error reference for this specific error.
```

## Example

```json
{
  "name": "checkout.payment.error",
  "type": "front-end_error",
  "code": "no_payment_methods_available",
  "detail": "No payment methods available",
  "documentation_url": "https://developer.paddle.com/api-reference/overview"
}
```