The Invoice object

An invoice represents an amount your customer owes. You create an invoice explicitly, or Fintoc generates one automatically from a subscription. Each invoice lists its line items, tracks its payment attempts, and reflects the status of the customer’s debt.

{
  "id": "inv_456789abcdef",
  "object": "invoice",
  "attempt_count": 1,
  "collection_method": "charge_automatically",
  "created_at": "2025-08-01T12:00:00Z",
  "currency": "CLP",
  "customer": "cus_asdlfknmuy",
  "default_payment_method": "pm_9asdfkjn23",
  "external_payment": false,
  "hosted_invoice_url": "https://acme.billing.fintoc.com/invoices/inv_456789abcdef",
  "lines": [
    {
      "id": "il_348nasdfsdf",
      "object": "line_item",
      "amount": 15000,
      "currency": "CLP",
      "period_end": "2025-09-01T00:00:00Z",
      "period_start": "2025-08-01T00:00:00Z",
      "quantity": 1
    }
  ],
  "metadata": {},
  "mode": "live",
  "next_payment_attempt_at": null,
  "payments": [
    {
      "amount": 15000,
      "currency": "CLP",
      "payment_intent": "pi_duinkasdfb",
      "status": "succeeded"
    }
  ],
  "status": "paid",
  "subscription": "sub_123489rnas",
  "total": 15000
}

The invoice contains the following attributes:

Attribute	Type	Description
`id`	`string`	Unique identifier for the invoice.
`object`	`string`	Type of the object. Always `invoice`.
`attempt_count`	`integer`	Number of payment attempts Fintoc has made on the invoice. `0` until the first attempt. Fintoc stops retrying after 5 attempts.
`collection_method`	`string`	How Fintoc collects the invoice. One of `charge_automatically` or `send_invoice`.
`created_at`	`string`	ISO 8601 datetime in UTC when the invoice was created.
`currency`	`string`	Three-letter ISO 4217 currency code. Fintoc supports only `CLP`.
`customer`	`string`	ID of the customer this invoice bills.
`default_payment_method`	`string` or `null`	ID of the payment method Fintoc charges when `collection_method` is `charge_automatically`. `null` if the invoice has no payment method.
`external_payment`	`boolean`	If `true`, you marked the invoice as paid because your customer paid it outside Fintoc.
`hosted_invoice_url`	`string` or `null`	URL for the Fintoc-hosted page where your customer can view and pay the invoice. The value is `null` until the invoice is `open`.
`lines`	`array`	Line items on the invoice. See the Line Item object below.
`metadata`	`object` or `null`	Set of key-value pairs you can attach to the invoice. Use `metadata` to store additional structured information about the invoice. `null` if the invoice has no metadata.
`mode`	`string`	API key mode. One of `live` or `test`.
`next_payment_attempt_at`	`string` or `null`	ISO 8601 datetime in UTC of the next automatic charge Fintoc has scheduled. `null` when Fintoc has no charge scheduled, including invoices whose `collection_method` is `send_invoice`.
`payments`	`array`	Payment attempts made against the invoice. See the Invoice Payment object below.
`status`	`string`	Current state of the invoice. One of `draft`, `open`, `paid`, or `void`.
`subscription`	`string` or `null`	ID of the subscription that generated this invoice. `null` for invoices you create directly.
`total`	`integer`	Total amount due, in the smallest currency unit. For example, `15000` for $15,000 CLP, since CLP has no minor unit.

Marking an invoice as paid outside Fintoc is irreversible. Once external_payment turns true, you cannot set it back to false.

An invoice with collection_method set to send_invoice stays open until you or your customer pays the invoice. You choose how: send the payment link, charge the invoice on demand, or collect the money outside Fintoc and mark the invoice as paid. Unpaid invoices accumulate, one per billing period, and each invoice is paid separately.

Nested object: Line Item

Each object in lines contains the following attributes:

Attribute	Type	Description
`id`	`string`	Unique identifier for the line item.
`object`	`string`	Type of the object. Always `line_item`.
`amount`	`integer`	Amount for this line item, in the smallest currency unit. For example, `15000` for $15,000 CLP, since CLP has no minor unit.
`currency`	`string`	Three-letter ISO 4217 currency code. Fintoc supports only `CLP`.
`period_end`	`string`	ISO 8601 datetime in UTC when the billing period ends.
`period_start`	`string`	ISO 8601 datetime in UTC when the billing period starts.
`quantity`	`integer`	Number of units for this line item.

Nested object: Invoice Payment

Each object in payments contains the following attributes:

Attribute	Type	Description
`amount`	`integer`	Payment amount, in the smallest currency unit. For example, `15000` for $15,000 CLP, since CLP has no minor unit.
`currency`	`string`	Three-letter ISO 4217 currency code. Fintoc supports only `CLP`.
`payment_intent`	`string`	ID of the `PaymentIntent` that processed this payment attempt.
`status`	`string`	Current state of the payment attempt. One of `pending`, `succeeded`, or `failed`.

​Nested object: Line Item

​Nested object: Invoice Payment

Nested object: Line Item

Nested object: Invoice Payment