For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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"
}
```
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
}
Authentication
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
