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

# PATCH /settings/checkout-url

**Update checkout URL settings**

Updates the checkout URL settings for your account.

Pass `null` to clear `default_url`.

Returns a `checkout_url_domain_not_approved` error if the URL's domain isn't an approved checkout domain for your account.

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

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

## Request body

- `default_url`: string (uri) | null — URL that Paddle opens when a checkout is created without a URL of its own. Pass `null` to clear it.

Must use `https`, and its domain must be an approved checkout domain for your account.

Paddle appends `?_ptxn=` and the transaction ID to this URL. The page must have Paddle.js set up to read it and open the checkout. (Length: 1–1000; pattern: `^https://[^\s]+$`)

### Request example

```json
{
  "default_url": "https://example.com/checkout"
}
```

## Response (200)

- `data`: object (required) — Represents the checkout URL settings for your account.
  - `default_url`: string (uri) | null (required) — URL that Paddle opens when a checkout is created without a URL of its own. `null` until set.

Must use `https`, and its domain must be an approved checkout domain for your account.

Paddle appends `?_ptxn=` and the transaction ID to this URL. The page must have Paddle.js set up to read it and open the checkout. (Length: 1–1000; pattern: `^https://[^\s]+$`)
- `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": {
    "default_url": "https://example.com/checkout"
  },
  "meta": {
    "request_id": "7b8c9d0e-1f2a-4b3c-9d4e-5f6a7b8c9d0e"
  }
}
```