Invoice representan un documento de cobro, que contiene ítems de línea, información de pago y seguimiento de estado.
{
"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. 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 |
lines[].currency | string | Código ISO de la moneda. 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 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 |
payments[].currency | string | Código ISO de la moneda. 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 |