---
title: "Update checkout URL settings"
method: PATCH
path: "/settings/checkout-url"
tags: ["Settings"]
---

# Update checkout URL settings

`PATCH /settings/checkout-url`

## Request

- Base URL: `https://sandbox-api.paddle.com`
- URL: `https://sandbox-api.paddle.com/settings/checkout-url`
- Auth: HTTP bearer

Updates the checkout URL settings for your account.

Pass `null` to clear `default_url`.

In live accounts, the URL's domain must be an approved checkout domain for your account, or the request returns a `checkout_url_domain_not_approved` error. Sandbox accounts accept any `https` URL.

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

## Request body

- CheckoutUrlUpdate: Represents the checkout URL settings for your account when updating them.
  - `default_url` string, uri, nullable: URL that Paddle opens when a checkout is created without a URL of its own. Pass `null` to clear it. Must use `https`. In live accounts, its domain must also 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.

## Response `200`

The request has succeeded.

- object
  - `data` CheckoutUrl, required: Represents the checkout URL settings for your account.
    - `default_url` string, uri, nullable, required: URL that Paddle opens when a checkout is created without a URL of its own. `null` until set. Must use `https`. In live accounts, its domain must also 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.
  - `meta` Meta, 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.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-10-19** (v1) `4f35a8c6ea4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paddlehq/apis/paddle-api/changes/settings/checkout-url/patch.md)

---

[API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [All operations](https://skmtc.dev/paddlehq/apis/paddle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paddlehq/apis/paddle-api/revisions/bbc0c72039c8?raw)