{
"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 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. |