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

# Objeto Invoice

Los objetos `Invoice` representan un documento de cobro, que contiene ítems de línea, información de pago y seguimiento de estado.

```json theme={null}
{
  "id": "inv_456789abcdef",
  "created_at": "2025-08-01T12:00:00Z",
  "currency": "CLP",
  "customer": "cus_asdlfknmuy",
  "lines": [
    {
      "id": "il_348nasdfsdf",
      "amount": 15000,
      "currency": "CLP",
      "object_name": "line_item",
      "period_end": "2025-09-01T00:00:00Z",
      "period_start": "2025-08-01T00:00:00Z",
      "quantity": 1
    }
  ],
  "metadata": {},
  "mode": "live",
  "object_name": "invoice",
  "payments": [
    {
      "amount": 15000,
      "currency": "CLP",
      "payment_intent": "pi_duinkasdfb",
      "status": "succeeded"
    }
  ],
  "status": "paid",
  "subscription": "sub_123489rnas",
  "total": 15000
}
```

| Atributo                    | Tipo      | Descripción                                                                                                                                                                                                                         |
| :-------------------------- | :-------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                        | `string`  | Identificador único del `Invoice`                                                                                                                                                                                                   |
| `created_at`                | `string`  | Fecha de creación, usando ISO 8601                                                                                                                                                                                                  |
| `currency`                  | `string`  | [Código ISO de la moneda](https://www.iso.org/iso-4217-currency-codes.html). Por ahora, solo soportamos CLP                                                                                                                         |
| `customer`                  | `string`  | ID del `Customer` asociado a este invoice                                                                                                                                                                                           |
| `lines`                     | `array`   | Lista de objetos de ítems de línea                                                                                                                                                                                                  |
| `lines[].id`                | `string`  | Identificador único del ítem de línea                                                                                                                                                                                               |
| `lines[].amount`            | `integer` | Monto, [representado como un entero](/es/v2023-11-15/docs/home/currencies)                                                                                                                                                          |
| `lines[].currency`          | `string`  | [Código ISO de la moneda](https://www.iso.org/iso-4217-currency-codes.html). Por ahora, solo soportamos CLP                                                                                                                         |
| `lines[].object_name`       | `string`  | Identificador del tipo de objeto. Su valor siempre será `line_item`                                                                                                                                                                 |
| `lines[].period_end`        | `string`  | Fin del período de cobro, usando ISO 8601                                                                                                                                                                                           |
| `lines[].period_start`      | `string`  | Inicio del período de cobro, usando ISO 8601                                                                                                                                                                                        |
| `lines[].quantity`          | `integer` | Cantidad de ítems                                                                                                                                                                                                                   |
| `metadata`                  | `hash`    | Conjunto de pares [clave-valor](/es/v2023-11-15/reference/fintoc-api/metadata) que puedes adjuntar a un objeto. Esto puede ser útil para almacenar información adicional sobre el objeto en un formato estructurado. Puede ser null |
| `mode`                      | `string`  | Indica si el `Invoice` está en modo `live` o en modo `test`                                                                                                                                                                         |
| `object_name`               | `string`  | Identificador del tipo de objeto. Su valor siempre será `invoice`                                                                                                                                                                   |
| `payments`                  | `array`   | Lista de objetos de intentos de pago                                                                                                                                                                                                |
| `payments[].amount`         | `integer` | Monto del pago, [representado como un entero](/es/v2023-11-15/docs/home/currencies)                                                                                                                                                 |
| `payments[].currency`       | `string`  | [Código ISO de la moneda](https://www.iso.org/iso-4217-currency-codes.html). Por ahora, solo soportamos CLP                                                                                                                         |
| `payments[].payment_intent` | `string`  | ID del `Payment Intent` asociado                                                                                                                                                                                                    |
| `payments[].status`         | `string`  | Estado del pago. Puede ser `pending`, `succeeded` o `failed`                                                                                                                                                                        |
| `status`                    | `string`  | Estado del invoice. Puede ser `open`, `paid` o `void`                                                                                                                                                                               |
| `subscription`              | `string`  | ID de la `Subscription` que generó el invoice, si la hay. Puede ser null                                                                                                                                                            |
| `total`                     | `integer` | Monto total, [representado como un entero](/es/v2023-11-15/docs/home/currencies)                                                                                                                                                    |