Subscription Object

{
  "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": "active"
}
AttributeTypeDescription
idstringUnique identifier for the subscription.
objectstringThe type of the object. Always "subscription"
billing_cycle_anchorstringISO 8601 timestamp. The reference point used to align feature invoices.
collection_methodstring"charge_automatically" or "send_invoice". When charging automatically, invoices attempt to automatically collect payments using a registered payment method.When sending_invoice, Fintoc will email your client in other to manually attempt the payment.
created_atstringISO 8601 creation timestamp
customerstringCustomer ID associated to this subscription
itemsarrayList of subscription item objects.
metadataobjectSet 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.
modestring"live" or "test"
payment_methodstringPayment method ID associated to this subscription. Necessary to automatically charge invoices
statusstring"active" or "canceled". Canceled subscriptions no longer create new invoices.

Subscription Item

AttributeTypeDescription
idstringUnique identifier for the subscription_item
objectstringAlways "subscription_item"
priceobjectPrice details for this item.
price.currencystringCurrency ISO code. Only CLP supported for the moment.
price.productobjectProduct information
price.product.namestringProduct name
price.recurringobjectRecurrence configuration
price.recurring.intervalstringThe frequency at which a subscription is billed. Only 'monthly' supported for the moment.
price.recurring.interval_countintegerNumber of intervals between billings.
price.unit_amountintegerUnit amount in cents to be charged for an item
quantityintegerQuantity of items