> ## 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.

# Checkout Session object

A `Checkout Session` represents a payment session in the Fintoc API.

```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"
}
```

| Attribute                | Type      | Description                                                                                                                                         |
| :----------------------- | :-------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                     | `string`  | Unique identifier for the Checkout Session.                                                                                                         |
| `object`                 | `string`  | Identifier for the type of object. Its value for `Checkout Session` will always correspond to `checkout_session`.                                   |
| `amount`                 | `integer` | Amount to pay, represented as an integer. This value must always be greater than 0.                                                                 |
| `business_profile`       | `hash`    | Optional object to identify enrolled merchants for category-based pricing.                                                                          |
| `cancel_url`             | `string`  | URL to redirect the user to if they cancel the payment.                                                                                             |
| `created_at`             | `string`  | Checkout Session's creation date, using ISO 8601.                                                                                                   |
| `currency`               | `string`  | Currency ISO code. Currently supports `CLP` and `MXN` only.                                                                                         |
| `customer`               | `hash`    | Customer data linked to the Checkout Session, including tax identification and refund contact information.                                          |
| `customer_email`         | `string`  | Customer email linked to the Checkout Session for refund notifications. Required if using the refunds product; will be `null` if not provided.      |
| `expires_at`             | `string`  | UTC timestamp in ISO 8601 format indicating session expiration. Must be at least 10 minutes after creation; defaults to 24 hours.                   |
| `metadata`               | `hash`    | Set of [key-value](/v2023-11-15/reference/fintoc-api/metadata) pairs for storing additional structured information. Will be `null` if not provided. |
| `mode`                   | `string`  | Indicates whether the session is in `live` or `test` mode.                                                                                          |
| `payment_method_options` | `hash`    | Optional set of settings for each available payment method.                                                                                         |
| `payment_methods`        | `array`   | Optional definition of the available payment method(s): `payment_intent` (bank transfers) and `card`.                                               |
| `payment_resource`       | `object`  | Payment resource associated with the session after completion. Will be `null` if the session is unfinished or expired.                              |
| `redirect_url`           | `string`  | URL to redirect the user to so they can complete the payment using the Fintoc widget.                                                               |
| `session_token`          | `string`  | Temporary token to configure the widget. Will be `null` if `success_url` and `cancel_url` are provided.                                             |
| `status`                 | `string`  | Session status. Can be `created`, `in_progress`, `finished`, or `expired`.                                                                          |
| `success_url`            | `string`  | URL to redirect the user to after a successful payment.                                                                                             |

## Customer object

Used to send customer data, including tax identification and refund contact information.

| Attribute  | Type     | Description                                                                                                              |
| :--------- | :------- | :----------------------------------------------------------------------------------------------------------------------- |
| `tax_id`   | `object` | Required object identifying the customer at the fiscal/regulatory level, with `type` (e.g. `cl_rut`) and `value` fields. |
| `name`     | `string` | Optional full name of the customer.                                                                                      |
| `email`    | `string` | Optional customer email for refund notifications.                                                                        |
| `metadata` | `object` | Optional custom data for additional customer information (internal IDs, CRM references, tags).                           |

## Business Profile object

| Attribute  | Type     | Description                                                                       |
| :--------- | :------- | :-------------------------------------------------------------------------------- |
| `category` | `string` | Merchant category identifier (6-character SII activity code in Chile).            |
| `name`     | `string` | Enrolled merchant's name. Displayed as "Recipient" on the payment success screen. |
| `tax_id`   | `string` | Enrolled merchant's tax identifier (RUT in Chile).                                |