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

{
  "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": {
          "id": "prod_a7dkfnea",
          "object": "product",
          "created_at": "2025-08-01T00:00:00Z",
          "description": null,
          "image_url": null,
          "metadata": {},
          "mode": "live",
          "name": "Pro Plan"
        },
        "recurring": {
          "interval": "month",
          "interval_count": 1
        },
        "unit_amount": 15000
      },
      "quantity": 1
    }
  ],
  "metadata": {},
  "mode": "live",
  "payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
  "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 deja cada factura abierta para que tú la cobres.
`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 que puedes adjuntar a la suscripción, útil para almacenar información estructurada adicional.
`mode`	`string`	Uno de `live` o `test`.
`payment_method`	`string` o `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`, `incomplete` (el pago de la primera factura todavía no resulta exitoso), `trialing` (el período de trial no terminó) o `canceled` (la suscripción dejó de generar facturas). Con `send_invoice` la suscripción nace `active`, porque Fintoc nunca la cobra. Con `charge_automatically` nace `incomplete` y pasa a `active` cuando el primer pago resulta exitoso.
`trial_end`	`string` o `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.

Con send_invoice, Fintoc nunca contacta a tu cliente. Cobrar cada factura es tu responsabilidad, sea que le envíes su link de pago, la cobres a pedido o recibas la plata fuera de Fintoc. Una suscripción active significa que Fintoc sigue generando facturas, no que tu cliente siga pagando esas facturas.

Asociar un payment method a una suscripción no cambia cómo Fintoc cobra sus invoices. El modo de cobro cambia solo a través de Actualizar una suscripción.

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. Consulta la tabla del objeto Price más abajo.
`quantity`	`integer`	Número de unidades facturadas.

El objeto Price (dentro del Subscription Item)

El campo price contiene la configuración de precio del subscription item.

Atributo	Tipo	Descripción
`currency`	`string`	Código de moneda ISO 4217 de tres letras. Fintoc solo soporta CLP.
`product`	`object`	Detalles del producto para este precio. Consulta la tabla del objeto Product más abajo.
`recurring`	`object`	Configuración de recurrencia de facturación. Consulta la tabla del objeto Recurring más abajo.
`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.

El objeto Product (dentro del objeto Price)

El campo product contiene el producto asociado al precio.

Atributo	Tipo	Descripción
`id`	`string`	Identificador único del producto.
`object`	`string`	Tipo del objeto. Siempre `product`.
`created_at`	`string`	Fecha y hora en ISO 8601 (UTC) en que se creó el producto.
`description`	`string` o `null`	Descripción del producto. `null` cuando no está definida.
`image_url`	`string` o `null`	URL de una imagen del producto. `null` cuando no está definida.
`metadata`	`object`	Conjunto de pares clave-valor adjuntos al producto.
`mode`	`string`	Uno de `live` o `test`.
`name`	`string`	Nombre del producto.

El objeto Recurring (dentro del objeto Price)

El campo recurring contiene la configuración de recurrencia de facturación del precio.

Atributo	Tipo	Descripción
`interval`	`string`	Frecuencia de facturación. Fintoc solo soporta `month`.
`interval_count`	`integer`	Número de intervalos entre facturaciones.

​Subscription Item

​El objeto Price (dentro del Subscription Item)

​El objeto Product (dentro del objeto Price)

​El objeto Recurring (dentro del objeto Price)

Subscription Item

El objeto Price (dentro del Subscription Item)

El objeto Product (dentro del objeto Price)

El objeto Recurring (dentro del objeto Price)