El objeto Invoice

Una invoice representa un monto que tu cliente te adeuda. Creas una invoice explícitamente, o Fintoc genera una automáticamente a partir de una suscripción. Cada invoice lista sus line items, registra sus intentos de pago y refleja el estado de la deuda del cliente.

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

La invoice contiene los siguientes atributos:

Atributo	Tipo	Descripción
`id`	`string`	Identificador único de la invoice.
`object`	`string`	Tipo del objeto. Siempre `invoice`.
`attempt_count`	`integer`	Cantidad de intentos de cobro que Fintoc hizo sobre la invoice. Es `0` hasta el primer intento. Fintoc deja de reintentar después de 5 intentos.
`collection_method`	`string`	Cómo Fintoc cobra la invoice. Uno de `charge_automatically` o `send_invoice`.
`created_at`	`string`	Fecha y hora ISO 8601 en UTC en que se creó la invoice.
`currency`	`string`	Código de moneda ISO 4217 de tres letras. Fintoc solo admite `CLP`.
`customer`	`string`	ID del cliente al que se le cobra esta invoice.
`default_payment_method`	`string` o `null`	ID del payment method que Fintoc cobra cuando `collection_method` es `charge_automatically`. El valor es `null` si la invoice no tiene payment method.
`external_payment`	`boolean`	Si es `true`, marcaste la invoice como pagada porque tu cliente la pagó fuera de Fintoc.
`hosted_invoice_url`	`string` o `null`	URL de la página alojada por Fintoc donde tu cliente puede ver y pagar la invoice. El valor es `null` hasta que la invoice esté `open`.
`lines`	`array`	Line items de la invoice. Consulta el objeto Line Item más abajo.
`metadata`	`object` o `null`	Conjunto de pares clave-valor que puedes adjuntar a la invoice. Usa `metadata` para almacenar información estructurada adicional sobre la invoice. El valor es `null` si la invoice no tiene metadata.
`mode`	`string`	Modo de la clave de API. Uno de `live` o `test`.
`next_payment_attempt_at`	`string` o `null`	Fecha y hora ISO 8601 en UTC del próximo cobro automático que Fintoc tiene agendado. El valor es `null` cuando Fintoc no tiene ningún cobro agendado, incluidas las invoices cuyo `collection_method` es `send_invoice`.
`payments`	`array`	Intentos de pago realizados contra la invoice. Consulta el objeto Invoice Payment más abajo.
`status`	`string`	Estado actual de la invoice. Uno de `draft`, `open`, `paid` o `void`.
`subscription`	`string` o `null`	ID de la suscripción que generó esta invoice. El valor es `null` para invoices que creas directamente.
`total`	`integer`	Monto total adeudado, en la unidad más pequeña de la moneda. Por ejemplo, `15000` para $15.000 CLP, ya que CLP no tiene unidad menor.

Marcar una invoice como pagada fuera de Fintoc es irreversible. Una vez que external_payment queda en true, no puedes volverlo a false.

Una invoice con collection_method en send_invoice queda open hasta que tú o tu cliente paguen la invoice. Tú eliges cómo: enviar el link de pago, cobrar la invoice a pedido, o cobrar la plata fuera de Fintoc y marcar la invoice como pagada. Las invoices impagas se acumulan, una por período de facturación, y cada invoice se paga por separado.

Objeto anidado: Line Item

Cada objeto de lines contiene los siguientes atributos:

Atributo	Tipo	Descripción
`id`	`string`	Identificador único del line item.
`object`	`string`	Tipo del objeto. Siempre `line_item`.
`amount`	`integer`	Monto de este line item, en la unidad más pequeña de la moneda. Por ejemplo, `15000` para $15.000 CLP, ya que CLP no tiene unidad menor.
`currency`	`string`	Código de moneda ISO 4217 de tres letras. Fintoc solo admite `CLP`.
`period_end`	`string`	Fecha y hora ISO 8601 en UTC en que finaliza el periodo de facturación.
`period_start`	`string`	Fecha y hora ISO 8601 en UTC en que comienza el periodo de facturación.
`quantity`	`integer`	Número de unidades de este line item.

Objeto anidado: Invoice Payment

Cada objeto de payments contiene los siguientes atributos:

Atributo	Tipo	Descripción
`amount`	`integer`	Monto del pago, en la unidad más pequeña de la moneda. Por ejemplo, `15000` para $15.000 CLP, ya que CLP no tiene unidad menor.
`currency`	`string`	Código de moneda ISO 4217 de tres letras. Fintoc solo admite `CLP`.
`payment_intent`	`string`	ID del `PaymentIntent` que procesó este intento de pago.
`status`	`string`	Estado actual del intento de pago. Uno de `pending`, `succeeded` o `failed`.

​Objeto anidado: Line Item

​Objeto anidado: Invoice Payment

Objeto anidado: Line Item

Objeto anidado: Invoice Payment