{
"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 | The type of the object. Always "subscription" |
billing_cycle_anchor | string | ISO 8601 timestamp. The reference point used to align feature invoices. |
collection_method | string | "charge_automatically" or "send_invoice". When charging automatically, invoices attempt to automatically collect payments using a registered payment method. When send_invoice, Fintoc emails your client to manually attempt the payment. |
created_at | string | ISO 8601 creation timestamp |
customer | string | Customer ID associated to this subscription |
items | array | List of subscription item objects. |
metadata | object | Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. |
mode | string | "live" or "test" |
payment_method | string | Payment method ID associated to this subscription. Necessary to automatically charge invoices |
status | string | "active", "trialing", or "canceled". Canceled subscriptions no longer create new invoices. |
trial_end | string | ISO 8601 timestamp 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 | Always "subscription_item" |
price | object | Price details for this item. |
price.currency | string | Currency ISO code. Only CLP supported for the moment. |
price.product | object | Product information |
price.product.name | string | Product name |
price.recurring | object | Recurrence configuration |
price.recurring.interval | string | The frequency at which a subscription is billed. Only 'monthly' supported for the moment. |
price.recurring.interval_count | integer | Number of intervals between billings. |
price.unit_amount | integer | Unit amount in cents to be charged for an item |
quantity | integer | Quantity of items |