Objeto Invoice

Los objetos 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

API de Fintoc

Recursos principales

API de Payment Initiation

API de Transferencias

API de Movimientos

Direct Debit y Suscripciones

API Fiscal

API de Billing

Objeto Invoice