> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```json theme={null}
{
  "id": "inv_456789abcdef",
  "object": "invoice",
  "created_at": "2025-08-01T12:00:00Z",
  "currency": "CLP",
  "customer": "cus_asdlfknmuy",
  "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",
  "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`.                                                                                                                                                                                                   |
| `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](https://www.iso.org/iso-4217-currency-codes.html). Fintoc solo admite `CLP`.                                                                                                               |
| `customer`           | `string`          | ID del cliente al que se le cobra esta invoice.                                                                                                                                                                                       |
| `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](/es/api/fintoc-api/metadata) 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`.                                                                                                                                                                                      |
| `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.                                                                                                |

## 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](https://www.iso.org/iso-4217-currency-codes.html). 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](https://www.iso.org/iso-4217-currency-codes.html). 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`.                                                     |