For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL.

Skip to content
Paddle Docs home

Update overlay checkout style settings

Updates the overlay checkout style settings for your account.

PATCH/settings/checkout-styles-overlay

Updates the overlay checkout style 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 primary_checkout_color and use the default checkout color.

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

Requires checkout_settings.write permission.

Request body

primary_checkout_colorstring | null

Brand color for overlay checkout, as a six-digit hex code including the leading #.

Pass null to clear the brand color and fall back to the default checkout color.

Pattern: ^#[0-9a-fA-F]{6}$

Response (200)

dataobjectrequired
Represents the overlay checkout style settings for your account.
primary_checkout_colorstring | nullrequired

Brand color for overlay checkout, as a six-digit hex code including the leading #.

null when no brand color is set, in which case the default checkout color applies.

Pattern: ^#[0-9a-fA-F]{6}$
metaobjectrequired
Information about this response.
request_idstringrequired
Example: b15ec92e-8688-40d4-a04d-f44cbec93355
Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.
Request
{
"primary_checkout_color": "#2E1065"
}
Response
{
"data": {
"primary_checkout_color": "#2E1065"
},
"meta": {
"request_id": "8f6e6c8e-6f2b-4b1c-9b2b-6f5e9e2b5e2b"
}
}

Was this page helpful?