Create Checkout
Creates a new custom checkout as a published clone of the account’s default checkout
PUBLISHED as a clone of the account’s default: payment methods — including icon/name overrides and required-field condition sets — are copied; general settings and styling inherit the account baseline until the checkout’s first Publish. It is never created as the account’s default.
The response’s top-level id is the checkout_code used by the Fetch, Publish, and Manage Checkout Lifecycle endpoints.
name is required, non-blank, and unique per account — a duplicate is rejected with 409. If the account has no default checkout to clone from, the request is rejected with 404.Authorizations
Merchant public API key. Found in Yuno dashboard → Settings → API Keys.
Merchant private secret key, paired with the public key. Never embed in client-side code.
UUID of the merchant account scope for the request. The tenant is resolved only from this header.
Headers
Optional client key, up to 64 characters. Best-effort — re-sending the same key is not guaranteed to be de-duplicated.
Body
Response
The created checkout. Born PUBLISHED as a clone of the account's default; is_default is always false on creation. Use id as the checkout_code in the other Checkout Builder endpoints.
Checkout identifier (UUID). Use it as the checkout_code in the fetch, publish, and lifecycle endpoints.
Checkout name.
Checkout description.
Whether this checkout is the account's default. A newly created checkout is never the default.
Whether the checkout is active (serving traffic).
Creation timestamp (ISO-8601).