Crear un checkout | Documentación API de Recurrente

Crea una nueva sesión de checkout. Cada elemento del arreglo items puede declararse de dos maneras:

Con un producto existente (recomendado): incluye product_id (o price_id si el producto tiene varios precios) y opcionalmente quantity. No envíes name, amount_in_cents, etc.; el producto ya tiene esa configuración.
Con detalles inline: incluye name, amount_in_cents, currency y los demás campos del cobro. Recurrente creará un producto invisible bajo la cuenta y lo asociará al checkout.

Ejemplo mínimo con un producto ya creado:

1 {
2   "items": [
3     { "product_id": "prod_1234567", "quantity": 1 }
4   ],
5   "success_url": "https://tusitio.com/exito",
6   "cancel_url": "https://tusitio.com/cancelar"
7 }

Crea una nueva sesión de checkout. Cada elemento del arreglo `items` puede declararse de dos maneras: - **Con un producto existente** (recomendado): incluye `product_id` (o `price_id` si el producto tiene varios precios) y opcionalmente `quantity`. No envíes `name`, `amount_in_cents`, etc.; el producto ya tiene esa configuración. - **Con detalles inline**: incluye `name`, `amount_in_cents`, `currency` y los demás campos del cobro. Recurrente creará un producto invisible bajo la cuenta y lo asociará al checkout. Ejemplo mínimo con un producto ya creado: ```json { "items": [ { "product_id": "prod_1234567", "quantity": 1 } ], "success_url": "https://tusitio.com/exito", "cancel_url": "https://tusitio.com/cancelar" } ```

Authentication

X-PUBLIC-KEYstring

Tu llave pública de API

X-SECRET-KEYstring

Tu llave secreta de API

Request

This endpoint expects an object.

itemslist of objectsOptional

Lista de productos/servicios a incluir en el checkout. Cada item puede usar product_id / price_id (producto existente) o los campos inline (name, amount_in_cents, currency, …). Los dos modos son excluyentes para un mismo item.

modeenumOptional

(Opcional) Modo del checkout. Envía setup para tokenizar una tarjeta sin cobrarla.

Allowed values:

success_urlstringOptionalformat: "uri"

(Opcional) URL a dónde dirigir al comprador después de un pago exitoso

cancel_urlstringOptionalformat: "uri"

(Opcional) URL a dónde dirigir al comprador cuando abandona el checkout

user_idstringOptional

(Opcional) ID del usuario a quien pertenece el checkout. Prepopula los campos de información de usuario (Nombre, Email, etc.)

metadatamap from strings to stringsOptional

(Opcional) Puedes utilizar metadata para almacenar información estructurada adicional sobre un producto. Puedes especificar hasta 50 keys, con nombres de hasta 40 caracteres y valores de hasta 500 caracteres.

expires_atdatetimeOptional

(Opcional) Fecha en la que quieres que el checkout expire, en formato ISO 8601

custom_account_idstringOptional

(Opcional) ID de la cuenta conectada (hijo) para crear el checkout en su nombre

discount_codestringOptional

(Opcional) Código de descuento/cupón a aplicar al checkout

transfer_setupslist of objectsOptional

(Opcional) Configuraciones de transferencia para dividir el pago después de un cobro exitoso

Response

Checkout creado exitosamente

idstring

ID del checkout creado

checkout_urlstring

URL del checkout donde el usuario puede pagar

Crea una nueva sesión de checkout. Cada elemento del arreglo items puede declararse de dos maneras:

Con un producto existente (recomendado): incluye product_id (o price_id si el producto tiene varios precios) y opcionalmente quantity. No envíes name, amount_in_cents, etc.; el producto ya tiene esa configuración.
Con detalles inline: incluye name, amount_in_cents, currency y los demás campos del cobro. Recurrente creará un producto invisible bajo la cuenta y lo asociará al checkout.

Ejemplo mínimo con un producto ya creado:

1 {
2   "items": [
3     { "product_id": "prod_1234567", "quantity": 1 }
4   ],
5   "success_url": "https://tusitio.com/exito",
6   "cancel_url": "https://tusitio.com/cancelar"
7 }

1	{
2	"items": [
3	{ "product_id": "prod_1234567", "quantity": 1 }
4	],
5	"success_url": "https://tusitio.com/exito",
6	"cancel_url": "https://tusitio.com/cancelar"
7	}