The 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": {
          "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"
}

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 leaves each invoice open for you to collect.
`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` or `null`	ID of the payment method used to charge this subscription automatically. `null` if no payment method is attached.
`status`	`string`	One of `active`, `incomplete` (the first invoice payment has not yet succeeded), `trialing` (the trial period has not ended), or `canceled` (the subscription stopped generating invoices). With `send_invoice`, the subscription starts `active` because Fintoc does not start an automatic charge. With `charge_automatically`, the subscription starts `incomplete` and turns `active` once the first payment succeeds.
`trial_end`	`string` or `null`	ISO 8601 datetime in UTC marking the end of the trial period. `null` if the subscription has no trial.

With send_invoice, Fintoc never contacts your customer. Collecting each invoice is your responsibility, whether you send its payment link, charge it on demand, or take the money outside Fintoc. An active subscription means Fintoc keeps generating invoices, not that your customer keeps paying those invoices.

Attaching a payment method to a subscription does not change how Fintoc collects its invoices. The collection method changes only through Update a subscription.

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. See the Price object table below.
`quantity`	`integer`	Number of units billed.

The Price object (within the Subscription Item)

The price field holds the price configuration for the subscription item.

Attribute	Type	Description
`currency`	`string`	Three-letter ISO 4217 currency code. One of `CLP`, `MXN`, or `CLF`. Fintoc bills a Unidad de Fomento (UF, `CLF`) price inside a `CLP` subscription.
`product`	`object`	Product details for this price. See the Product object table below.
`recurring`	`object`	Billing recurrence configuration. See the Recurring object table below.
`unit_amount`	`integer`	Amount charged per unit, in the smallest currency unit. CLP has no minor unit, so `15000` means 15,000 CLP. CLF has four decimals, so `35000` means 3.5 UF.

The Product object (within the Price object)

The product field holds the product associated with the price.

Attribute	Type	Description
`id`	`string`	Unique identifier for the product.
`object`	`string`	Type of the object. Always `product`.
`created_at`	`string`	ISO 8601 datetime in UTC when the product was created.
`description`	`string` or `null`	Description of the product. `null` when not set.
`image_url`	`string` or `null`	URL of an image for the product. `null` when not set.
`metadata`	`object`	Set of key-value pairs attached to the product.
`mode`	`string`	One of `live` or `test`.
`name`	`string`	Name of the product.

The Recurring object (within the Price object)

The recurring field holds the billing recurrence configuration for the price.

Attribute	Type	Description
`interval`	`string`	Billing frequency. Fintoc supports `month` only.
`interval_count`	`integer`	Number of intervals between billings.

Prices in UF (`CLF`)

To bill a plan indexed to UF, set the price’s currency to CLF. Set unit_amount in the smallest UF unit, which has four decimals. For example, unit_amount: 35000 prices the item at 3.5 UF. The subscription and its invoices stay in CLP. When Fintoc generates an invoice, Fintoc converts every CLF item to CLP using the UF value at the start of the billing period. The amount your customer pays follows the UF value for that day. Once Fintoc issues the invoice, the invoice amount no longer changes. A subscription can combine CLP and CLF items. Any other currency mix, such as an MXN item alongside a CLP item, returns an error, and Fintoc does not create the subscription.

​Subscription Item

​The Price object (within the Subscription Item)

​The Product object (within the Price object)

​The Recurring object (within the Price object)

​Prices in UF (CLF)

Subscription Item

The Price object (within the Subscription Item)

The Product object (within the Price object)

The Recurring object (within the Price object)

Prices in UF (`CLF`)