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

Una suscripción factura a tu cliente en un calendario recurrente. La suscripción agrupa los items facturables, rastrea el ciclo de facturación y genera una factura por cada período. La suscripción refleja si la facturación está activa, en un trial o cancelada.

```json theme={null}
{
  "id": "sub_456789abcdef",
  "object": "subscription",
  "billing_cycle_anchor": "2025-08-01T00:00:00Z",
  "collection_method": "charge_automatically",
  "created_at": "2025-08-01T12:00:00Z",
  "customer": "cus_01234567",
  "items": [
    {
      "id": "si_89abcdef0123",
      "object": "subscription_item",
      "price": {
        "currency": "CLP",
        "product": {
          "name": "Pro Plan"
        },
        "recurring": {
          "interval": "month",
          "interval_count": 1
        },
        "unit_amount": 15000
      },
      "quantity": 1
    }
  ],
  "metadata": {},
  "mode": "live",
  "payment_method": null,
  "status": "trialing",
  "trial_end": "2025-10-01T00:00:00Z"
}
```

| Atributo               | Tipo           | Descripción                                                                                                                                                                                                                                      |
| ---------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`                   | string         | Identificador único de la suscripción.                                                                                                                                                                                                           |
| `object`               | string         | Tipo del objeto. Siempre `"subscription"`.                                                                                                                                                                                                       |
| `billing_cycle_anchor` | string         | Punto de referencia usado para alinear las futuras facturas. Fecha y hora en ISO 8601 (UTC).                                                                                                                                                     |
| `collection_method`    | string         | Uno de `"charge_automatically"` o `"send_invoice"`. Con `"charge_automatically"`, Fintoc cobra cada factura usando el payment method asociado. Con `"send_invoice"`, Fintoc envía un email a tu cliente para que pague cada factura manualmente. |
| `created_at`           | string         | Fecha y hora en ISO 8601 (UTC) en que se creó la suscripción.                                                                                                                                                                                    |
| `customer`             | string         | ID del customer al que factura esta suscripción.                                                                                                                                                                                                 |
| `items`                | array          | Lista de objetos subscription item. Ver los atributos de Subscription Item abajo.                                                                                                                                                                |
| `metadata`             | object         | Conjunto de pares [clave-valor](/es/reference/fintoc-api/metadata) que puedes adjuntar a la suscripción, útil para almacenar información estructurada adicional.                                                                                 |
| `mode`                 | string         | Uno de `"live"` o `"test"`.                                                                                                                                                                                                                      |
| `payment_method`       | string \| null | ID del payment method usado para cobrar esta suscripción automáticamente. `null` si no hay payment method asociado.                                                                                                                              |
| `status`               | string         | Uno de `"active"`, `"trialing"` o `"canceled"`. Una suscripción cancelada ya no crea facturas.                                                                                                                                                   |
| `trial_end`            | string \| null | Fecha y hora en ISO 8601 (UTC) que marca el fin del período de trial. `null` si la suscripción no tiene trial.                                                                                                                                   |

## Subscription Item

| Atributo                         | Tipo    | Descripción                                                                                                                  |
| -------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `id`                             | string  | Identificador único del subscription item.                                                                                   |
| `object`                         | string  | Tipo del objeto. Siempre `"subscription_item"`.                                                                              |
| `price`                          | object  | Detalles del precio para este item.                                                                                          |
| `price.currency`                 | string  | Código de moneda ISO 4217 de tres letras. Fintoc solo soporta CLP.                                                           |
| `price.product`                  | object  | Detalles del producto para este item.                                                                                        |
| `price.product.name`             | string  | Nombre del producto.                                                                                                         |
| `price.recurring`                | object  | Configuración de recurrencia de facturación.                                                                                 |
| `price.recurring.interval`       | string  | Frecuencia de facturación. Fintoc solo soporta `month`.                                                                      |
| `price.recurring.interval_count` | integer | Número de intervalos entre facturaciones.                                                                                    |
| `price.unit_amount`              | integer | Monto cobrado por unidad, en la unidad mínima de la moneda. CLP no tiene unidad menor, así que `15000` significa 15.000 CLP. |
| `quantity`                       | integer | Número de unidades facturadas.                                                                                               |

<br />