Saltar al contenido principal
PUT
Esta API está en Beta. Los endpoints y los esquemas pueden cambiar sin previo aviso.

Autorizaciones

PUBLIC-API-KEY
string
header
requerido

Clave de API pública del comercio. Se encuentra en el Dashboard de Yuno → Settings → API Keys.

PRIVATE-SECRET-KEY
string
header
requerido

Clave secreta privada del comercio, asociada a la clave pública. Nunca la incluyas en código del lado del cliente.

X-Account-Code
string
header
requerido

UUID del ámbito de la cuenta del comercio para la solicitud. El tenant se resuelve únicamente a partir de este encabezado.

Encabezados

X-Idempotency-Key
string

UUID generado por el cliente. Reenviar la misma solicitud con la misma clave es seguro y no publicará dos veces.

Parámetros de ruta

checkout_code
string
requerido

El identificador único del checkout que se va a actualizar (UUID, 36 caracteres). Los valores que no son UUID se rechazan con 400 antes de procesarse.

Cuerpo

application/json

Se requiere al menos uno de config o styling. name es obligatorio cuando se envía config.

name
string

Nombre de la configuración del checkout (de 1 a 50 caracteres). Obligatorio cuando el cuerpo incluye config; una solicitud con config y sin name devuelve 400 name must not be blank. Una solicitud solo de estilos no lo necesita. El valor reemplaza el nombre actual del checkout, así que envía el nombre actual para conservarlo.

Required string length: 1 - 50
Ejemplo:

"Main checkout"

config
object

Configuración del checkout: métodos de pago y configuración general. Upsert parcial; los métodos de pago omitidos conservan su estado anterior.

styling
object

Estilos del checkout y configuración del SDK. Combinación parcial; los campos omitidos o nulos se conservan; usa flags.force_default_styles para restablecer. settings.urls, settings.click_to_pay, settings.form y settings.google_pay están bloqueados en la beta y se rechazan si se envían con un valor no vacío.

Respuesta

Resumen del checkout actualizado. La configuración y los estilos no se devuelven en esta respuesta; consúltalos con Fetch checkout configuration. Su identificador se expone como el id de nivel superior.

id
string
Ejemplo:

"8005ca91-dcfb-4428-b9f6-49c6e3446474"

name
string
Ejemplo:

"Main Checkout"

description
string
Ejemplo:

"Default checkout"

is_default
boolean
Ejemplo:

true

is_active
boolean
Ejemplo:

true

created_at
string
Ejemplo:

"2026-10-22T03:16:36Z"