Saltar al contenido principal
POST
Esta API está en Beta. Los endpoints y los esquemas pueden cambiar sin previo aviso.
El nuevo checkout nace PUBLISHED como un clon del predeterminado de la cuenta: se copian los métodos de pago (incluidos los cambios de ícono y nombre y los conjuntos de condiciones de campos obligatorios); la configuración general y el estilo heredan la base de la cuenta hasta la primera Publicación del checkout. Nunca se crea como el checkout predeterminado de la cuenta. El id de nivel superior de la respuesta es el checkout_code que usan los endpoints Obtener, Publicar y Gestionar ciclo de vida del checkout. name es obligatorio, no puede estar en blanco y debe ser único por cuenta; un duplicado se rechaza con 409. Si la cuenta no tiene un checkout predeterminado del cual clonar, la solicitud se rechaza con 404.

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

Clave opcional del cliente, de hasta 64 caracteres. Se aplica con el mejor esfuerzo; si se reenvía la misma clave, no se garantiza que se elimine la duplicación.

Cuerpo

application/json
name
string
requerido

Nombre del checkout. Obligatorio, no puede estar en blanco y debe ser único por cuenta (un nombre duplicado se rechaza con 409).

description
string

Descripción opcional de texto libre.

Respuesta

El checkout creado. Nace PUBLISHED como un clon del predeterminado de la cuenta; is_default siempre es false al crearlo. Usa id como checkout_code en los demás endpoints de Checkout Builder.

id
string

Identificador del checkout (UUID). Úsalo como checkout_code en los endpoints de consulta, publicación y ciclo de vida.

name
string

Nombre del checkout.

description
string

Descripción del checkout.

is_default
boolean

Indica si este checkout es el predeterminado de la cuenta. Un checkout recién creado nunca es el predeterminado.

is_active
boolean

Indica si el checkout está activo (atendiendo tráfico).

created_at
string<date-time>

Marca de tiempo de creación (ISO-8601).