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

# PATCH /settings/checkout-recovery

**Update checkout recovery settings**

Updates the checkout recovery settings for your account.

Send only the fields that you want to change. Fields that you omit keep their current value. Pass `null` to clear `discount` and stop offering a discount.

If successful, your response includes a copy of the updated checkout recovery settings entity.

**Required permissions:** `checkout_settings.write`

## Request body

- `enabled`: boolean — Whether Paddle emails customers who abandon a checkout.
- `discount`: object | null — Discount offered in the recovery email. Pass `null` to stop offering one.
  - `type`: string (required) — Kind of discount. `percentage` is the only kind.
    - `percentage` — Discount is a percentage of the transaction total.
  - `amount`: string (required) — Percentage taken off the transaction total, as a string containing a whole number from `1` to `100`.

`"10"` means 10%. (pattern: `^(100|[1-9][0-9]?)$`)

### Request example

```json
{
  "enabled": true,
  "discount": {
    "type": "percentage",
    "amount": "10"
  }
}
```

## Response (200)

- `data`: object (required) — Represents the checkout recovery settings for your account.
  - `enabled`: boolean (required) — Whether Paddle emails customers who abandon a checkout.
  - `discount`: object | null (required) — Discount offered in the recovery email, or `null` when no discount is offered.
    - `type`: string (required) — Kind of discount. `percentage` is the only kind.
      - `percentage` — Discount is a percentage of the transaction total.
    - `amount`: string (required) — Percentage taken off the transaction total, as a string containing a whole number from `1` to `100`.

`"10"` means 10%. (pattern: `^(100|[1-9][0-9]?)$`)
- `meta`: object (required) — Information about this response.
  - `request_id`: string (required) — Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.

### Response example

```json
{
  "data": {
    "enabled": true,
    "discount": {
      "type": "percentage",
      "amount": "10"
    }
  },
  "meta": {
    "request_id": "d1a2f3b4-5c6d-4e7f-8a9b-0c1d2e3f4a5b"
  }
}
```