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. Uno de `CLP`, `MXN` o `CLF`. Fintoc factura un precio en Unidad de Fomento (UF, `CLF`) dentro de una suscripción en `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. CLF tiene cuatro decimales, así que `35000` significa 3,5 UF.

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.

Precios en UF (`CLF`)

Para facturar un plan indexado a UF, define la currency del precio como CLF. Define el unit_amount en la unidad mínima de la UF, que tiene cuatro decimales. Por ejemplo, unit_amount: 35000 fija el precio del ítem en 3,5 UF. La suscripción y sus facturas se mantienen en CLP. Cuando Fintoc genera una factura, Fintoc convierte cada ítem en CLF a CLP usando el valor de la UF al inicio del período de facturación. El monto que paga tu cliente sigue el valor de la UF de ese día. Una vez que Fintoc emite la factura, el monto de la factura ya no cambia. Una suscripción puede combinar ítems en CLP y en CLF. Cualquier otra combinación de monedas, como un ítem en MXN junto a un ítem en CLP, devuelve un error y Fintoc no crea la suscripción.

​Subscription Item

​El objeto Price (dentro del Subscription Item)

​El objeto Product (dentro del objeto Price)

​El objeto Recurring (dentro del objeto Price)

​Precios en UF (CLF)

Subscription Item

El objeto Price (dentro del Subscription Item)

El objeto Product (dentro del objeto Price)

El objeto Recurring (dentro del objeto Price)

Precios en UF (`CLF`)