Subscription object

A subscription bills your customer on a recurring schedule. The subscription groups billable items, tracks the billing cycle, and generates an invoice for each period. The subscription reflects whether billing is active, in a trial, or canceled.

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