Skip to main content
PUT
Publish Checkout Configuration
This API is in Beta. Endpoints and schemas may change without prior notice.

Authorizations

PUBLIC-API-KEY
string
header
required

Merchant public API key. Found in Yuno dashboard → Settings → API Keys.

PRIVATE-SECRET-KEY
string
header
required

Merchant private secret key, paired with the public key. Never embed in client-side code.

X-Account-Code
string
header
required

UUID of the merchant account scope for the request. The tenant is resolved only from this header.

Headers

X-Idempotency-Key
string

Client-generated UUID. Re-sending the same request with the same key is safe and will not double-publish.

Path Parameters

checkout_code
string
required

The unique identifier of the checkout to update (UUID, 36 chars). Non-UUID values are rejected with 400 before processing.

Body

application/json

At least one of config or styling is required.

config
object

Checkout configuration: payment methods and general settings. Sparse upsert — omitted payment methods keep their previous state.

styling
object

Checkout styling and SDK settings. Partial merge — omitted or null fields are preserved; use flags.force_default_styles to reset. settings.urls, settings.click_to_pay, settings.form and settings.google_pay are beta-locked and rejected if sent with a non-empty value.

Response

The updated checkout (configuration + styling composed). Its identifier is exposed as the top-level id.

The response is of type object.