{
"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"
}
| Attribute | Type | Description |
|---|---|---|
id | string | Unique identifier for the subscription. |
object | string | Type of the object. Always "subscription". |
billing_cycle_anchor | string | Reference point used to align future invoices. ISO 8601 datetime in UTC. |
collection_method | string | One of "charge_automatically" or "send_invoice". With "charge_automatically", Fintoc collects each invoice using the attached payment method. With "send_invoice", Fintoc emails your customer to pay each invoice manually. |
created_at | string | ISO 8601 datetime in UTC when the subscription was created. |
customer | string | ID of the customer this subscription bills. |
items | array | List of subscription item objects. See the Subscription Item attributes below. |
metadata | object | Set of key-value pairs you can attach to the subscription, useful for storing additional structured information. |
mode | string | One of "live" or "test". |
payment_method | string | null | ID of the payment method used to charge this subscription automatically. null if no payment method is attached. |
status | string | One of "active", "trialing", or "canceled". A canceled subscription no longer creates invoices. |
trial_end | string | null | ISO 8601 datetime in UTC marking the end of the trial period. null if the subscription has no trial. |
Subscription Item
| Attribute | Type | Description |
|---|---|---|
id | string | Unique identifier for the subscription item. |
object | string | Type of the object. Always "subscription_item". |
price | object | Price details for this item. |
price.currency | string | Three-letter ISO 4217 currency code. Fintoc supports CLP only. |
price.product | object | Product details for this item. |
price.product.name | string | Name of the product. |
price.recurring | object | Billing recurrence configuration. |
price.recurring.interval | string | Billing frequency. Fintoc supports month only. |
price.recurring.interval_count | integer | Number of intervals between billings. |
price.unit_amount | integer | Amount charged per unit, in the smallest currency unit. CLP has no minor unit, so 15000 means 15,000 CLP. |
quantity | integer | Number of units billed. |