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

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, hace seguimiento de 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
}
```

| 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. Fintoc solo admite CLP.                                                                                                                                    |
| `customer`           | string         | ID del cliente al que se le cobra esta invoice.                                                                                                                                                      |
| `hosted_invoice_url` | string \| null | URL de la página alojada por Fintoc donde tu cliente puede ver y pagar la invoice. `null` hasta que la invoice esté `open`.                                                                          |
| `lines`              | array          | Line items de la invoice. Consulta los atributos de Line Item más abajo.                                                                                                                             |
| `metadata`           | object \| null | Conjunto de pares [clave-valor](/es/reference/fintoc-api/metadata) que puedes adjuntar a la invoice, útil para almacenar información estructurada adicional. `null` si la invoice no tiene metadata. |
| `mode`               | string         | Uno de `"live"` o `"test"`.                                                                                                                                                                          |
| `payments`           | array          | Intentos de pago realizados contra la invoice. Consulta los atributos de Invoice Payment más abajo.                                                                                                  |
| `status`             | string         | Uno de `"draft"`, `"open"`, `"paid"` o `"void"`.                                                                                                                                                     |
| `subscription`       | string \| null | ID de la suscripción que generó esta invoice. `null` para invoices que creas directamente.                                                                                                           |
| `total`              | integer        | Monto total adeudado, en la unidad más pequeña de la moneda. CLP no tiene unidad menor, por lo que `15000` significa 15.000 CLP.                                                                     |

## Objeto anidado: Line Item

| 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.         |
| `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 para el fin del periodo de facturación.    |
| `period_start` | string  | Fecha y hora ISO 8601 en UTC para el inicio del periodo de facturación. |
| `quantity`     | integer | Número de unidades de este line item.                                   |

## Objeto anidado: Invoice Payment

| Atributo         | Tipo    | Descripción                                                       |
| ---------------- | ------- | ----------------------------------------------------------------- |
| `amount`         | integer | Monto del pago, en la unidad más pequeña de la moneda.            |
| `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  | Uno de `"pending"`, `"succeeded"` o `"failed"`.                   |

<br />