Checkout Session representa una sesión de pago en la API de Fintoc.
{
"id": "cs_li5531onlFDi235",
"object": "checkout_session",
"amount": 350000,
"business_profile": {},
"cancel_url": "https://merchant.com/987654321",
"created_at": "2026-01-13T18:48:25Z",
"currency": "CLP",
"customer": {
"name": "Felipe Castro",
"email": "felipe@example.com",
"metadata": {},
"tax_id": {
"type": "cl_rut",
"value": "12088191"
}
},
"customer_email": null,
"expires_at": "2026-01-14T18:48:25Z",
"metadata": {},
"mode": "test",
"payment_method_options": {},
"payment_methods": ["payment_intent"],
"payment_resource": {
"payment_intent": {
"id": "pi_38DNJo3rbvGUzKFvCGZ6dxR1Kxx",
"object": "payment_intent",
"amount": 350000,
"business_profile": {},
"created_at": "2026-01-13T18:48:31Z",
"currency": "CLP",
"customer_email": null,
"error_reason": null,
"expires_at": "2026-01-14T18:48:25Z",
"metadata": {},
"mode": "test",
"payment_type": "bank_transfer",
"payment_type_options": {},
"recipient_account": null,
"reference_id": null,
"sender_account": {
"type": "checking_account",
"number": "813990168",
"holder_id": "415792638",
"institution_id": "cl_banco_falabella"
},
"status": "succeeded",
"transaction_date": null,
"widget_token": null
}
},
"redirect_url": "https://checkout.fintoc.com/checkout_session_01HXY3Z7X5YQ54V8G2E1KJQAVF",
"session_token": null,
"status": "finished",
"success_url": "https://merchant.com/success"
}
| Atributo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único del Checkout Session. |
object | string | Identificador del tipo de objeto. Su valor para el Checkout Session siempre corresponderá a checkout_session. |
amount | integer | Monto a pagar, representado como un entero. Este valor siempre debe ser mayor que 0. |
business_profile | hash | Objeto opcional para identificar comercios inscritos para precios basados en categoría. |
cancel_url | string | URL a la que se redirige al usuario si cancela el pago. |
created_at | string | Fecha de creación del Checkout Session, usando ISO 8601. |
currency | string | Código ISO de la moneda. Por ahora solo soporta CLP y MXN. |
customer | hash | Datos del cliente vinculados al Checkout Session, incluyendo identificación fiscal e información de contacto para reembolsos. |
customer_email | string | Email del cliente vinculado al Checkout Session para notificaciones de reembolsos. Requerido si usas el producto de reembolsos; será null si no se proporciona. |
expires_at | string | Timestamp UTC en formato ISO 8601 que indica la expiración de la sesión. Debe ser al menos 10 minutos después de la creación; por defecto es 24 horas. |
metadata | hash | Conjunto de pares clave-valor para almacenar información adicional estructurada. Será null si no se proporciona. |
mode | string | Indica si la sesión está en modo live o test. |
payment_method_options | hash | Conjunto opcional de configuraciones para cada método de pago disponible. |
payment_methods | array | Definición opcional del o los métodos de pago disponibles: payment_intent (transferencias bancarias) y card. |
payment_resource | object | Recurso de pago asociado a la sesión después de completarse. Será null si la sesión está incompleta o expirada. |
redirect_url | string | URL a la que se redirige al usuario para que complete el pago usando el widget de Fintoc. |
session_token | string | Token temporal para configurar el widget. Será null si se proporcionan success_url y cancel_url. |
status | string | Estado de la sesión. Puede ser created, in_progress, finished o expired. |
success_url | string | URL a la que se redirige al usuario después de un pago exitoso. |
Objeto Customer
Se usa para enviar datos del cliente, incluyendo identificación fiscal e información de contacto para reembolsos.| Atributo | Tipo | Descripción |
|---|---|---|
tax_id | object | Objeto requerido que identifica al cliente a nivel fiscal/regulatorio, con los campos type (por ejemplo, cl_rut) y value. |
name | string | Nombre completo del cliente, opcional. |
email | string | Email del cliente para notificaciones de reembolsos, opcional. |
metadata | object | Datos personalizados opcionales para información adicional del cliente (IDs internos, referencias de CRM, etiquetas). |
Objeto Business Profile
| Atributo | Tipo | Descripción |
|---|---|---|
category | string | Identificador de la categoría del comercio (código de actividad del SII de 6 caracteres en Chile). |
name | string | Nombre del comercio inscrito. Se muestra como “Destinatario” en la pantalla de pago exitoso. |
tax_id | string | Identificador tributario del comercio inscrito (RUT en Chile). |