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