> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Objeto Checkout Session

Un `Checkout Session` representa una sesión de pago en la API de Fintoc.

```json theme={null}
{
  "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](/es/v2023-11-15/reference/fintoc-api/metadata) 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).                                     |