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