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

Los objetos `Subscription` representan un acuerdo de cobro recurrente para un cliente. Contienen ítems de suscripción que definen qué se cobra y con qué frecuencia.

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

| Atributo                                 | Tipo      | Descripción                                                                                                                                                                                                          |
| :--------------------------------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                                     | `string`  | Identificador único de la `Subscription`                                                                                                                                                                             |
| `object`                                 | `string`  | Identificador del tipo de objeto. Su valor siempre será `subscription`                                                                                                                                               |
| `billing_cycle_anchor`                   | `string`  | Timestamp ISO 8601 que alinea la generación de invoices                                                                                                                                                              |
| `collection_method`                      | `string`  | Cómo se maneja el pago. Puede ser `charge_automatically` o `send_invoice`                                                                                                                                            |
| `created_at`                             | `string`  | Fecha de creación, usando ISO 8601                                                                                                                                                                                   |
| `customer`                               | `string`  | ID del `Customer` asociado a esta suscripción                                                                                                                                                                        |
| `items`                                  | `array`   | Lista de objetos de ítems de suscripción                                                                                                                                                                             |
| `items[].id`                             | `string`  | Identificador único del ítem de suscripción                                                                                                                                                                          |
| `items[].object`                         | `string`  | Identificador del tipo de objeto. Su valor siempre será `subscription_item`                                                                                                                                          |
| `items[].price`                          | `hash`    | Detalles de precio del ítem                                                                                                                                                                                          |
| `items[].price.currency`                 | `string`  | [Código ISO de la moneda](https://www.iso.org/iso-4217-currency-codes.html). Por ahora, solo soportamos CLP                                                                                                          |
| `items[].price.product`                  | `hash`    | Información del producto                                                                                                                                                                                             |
| `items[].price.product.name`             | `string`  | Nombre del producto                                                                                                                                                                                                  |
| `items[].price.recurring`                | `hash`    | Configuración de recurrencia del cobro                                                                                                                                                                               |
| `items[].price.recurring.interval`       | `string`  | Frecuencia de cobro. Por ahora, solo soportamos `month`                                                                                                                                                              |
| `items[].price.recurring.interval_count` | `integer` | Número de intervalos entre cobros                                                                                                                                                                                    |
| `items[].price.unit_amount`              | `integer` | Monto del cobro por unidad, [representado como un entero](/es/v2023-11-15/docs/home/currencies)                                                                                                                      |
| `items[].quantity`                       | `integer` | Cantidad del ítem                                                                                                                                                                                                    |
| `metadata`                               | `hash`    | Conjunto de pares [clave-valor](/es/v2023-11-15/reference/fintoc-api/metadata) que puedes adjuntar a un objeto. Esto puede ser útil para almacenar información adicional sobre el objeto en un formato estructurado. |
| `mode`                                   | `string`  | Indica si la `Subscription` está en modo `live` o en modo `test`                                                                                                                                                     |
| `payment_method`                         | `string`  | ID del `Payment Method` usado para el cobro automático. Puede ser null                                                                                                                                               |
| `status`                                 | `string`  | Estado de la suscripción. Puede ser `active` o `canceled`                                                                                                                                                            |