Atributos

id string
Identificador único del Invoice.

customer string
ID del Customer entregado en su creación.

subscription nullable string
ID de la Subscription entregado en su creación.

product_id nullable string
Identificador interno del producto que genera el Invoice. Puede ser un número de contrato o de propuesta.

amount nullable float
Monto adeudado en la moneda del país.

due_date date
Fecha de vencimiento del Invoice, en formato YYYY-MM-DD.

is_paid nullable boolean
Indica si la Invoice se encuentra pagado o no.

is_void nullable boolean
Indica si la Invoice se encuentra anulado o no. Los Invoices anulados se tratan como si hubiesen sido borrados.

link_payment nullable string
URL en el que se debe pagar la Invoice. Dejar en blanco en caso de usar el portal de pagos de Toku. Incluir solo en el caso de que poseas tu propio procesador de pagos.

metadata nullable json
Valores adicionales específicos de cada cliente. Son tratados como valores de texto y no pueden tener más de 256 caracteres cada uno. Debes agregarlos en la webapp de Toku antes de poder utilizarlos aquí.

currency_code string
Código de la moneda de la Invoice.

receipt_type 🧾 nullable string
Tipo para emitir recibo. Puede ser bill (boleta) o invoice (factura).

id_receipt 🧾 nullable string
ID del recibo asociado a la Invoice.

disable_automatic_payment boolean
Indica si se debe deshabilitar el cobro automático de la Invoice. Falso por defecto.

invoice_external_id nullable string
Identificador único de la deuda para los casos en que se deba crear deudas con el mismo ID de producto y fecha de vencimiento.

status string
Estado del invoice. Puede tener los siguientes valores:

DELETED
VOID
UNPAID
PAID
PARTIALLY_PAID
UNPAID_PAYMENT_IN_PROGRESS
PARTIALLY_PAID_PAYMENT_IN_PROGRESS
UNPAID_NON_BLOCKING_PAYMENT_IN_PROGRESS
PARTIALLY_PAID_NON_BLOCKING_PAYMENT_IN_PROGRESS
UNPAID_PARTIAL_PAYMENT_IN_PROGRESS
PARTIALLY_PAID_PARTIAL_PAYMENT_IN_PROGRESS

Agregado en versión: 2025-09-03

paid_amount: nullable float

Cantidad pagada de la invoice. Se utiliza para pagos parciales.

Agregado en versión: 2025-09-03

expiration_date: nullable datetime

Fecha y hora exacta de expiración de la invoice Ejemplo: 2025-03-10 00:00:00. A partir de esta fecha y hora no se realizarán intentos de cobro.

Restricción actual: Por el momento, las invoices sólo pueden crearse y editarse con una hora de expiración equivalente a las 00:00 en la zona horaria local del país de la organización. Esto implica que el valor enviado debe representar la medianoche local. No se soportan horarios distintos a medianoche (ej: 12:00, 18:30, etc.)

Agregado en versión: 2025-11-10

max_collection_attempts: nullable integer

Número máximo de intentos de cobro antes de que la invoice expire y se elimine, anule o marque como expirada (según se configure)

remaining_collection_attempts: nullable integer

Número de intentos de cobro restantes. Se modifica en su totalidad si cambia el max_collection_attempts

Agregado en versión: 2025-11-10

expiration_action: nullable enum

Acción a ejecutar cuando se cumpla la condición de expiración. Valores posibles: VOIDED, DELETED.

Agregado en versión: 2025-11-10

Ejemplo

{
  "id": "in_K3a1P1_p_t5UHJHJXmpkQYmqXCHvXrNi",
  "customer": "cus_M2aYvh3QOfVylcre5gIMyIhYPrHBKfw2",
  "subscription": "sub_M2aYvh3QOfVylcre5gIMyIhYPrHBKfw2",
  "is_paid": false,
  "is_void": false,
  "amount": 1000.0000,
  "product_id": "92792",
  "due_date": "2021-03-04",
  "link_payment": "https://portal.pagos.com/tu-empresa",
  "currency_code": "CLP",
  "metadata": {
    "car_brand": "Toyota",
    "car_model": "Yaris",
  },
  "receipt_type": null,
  "id_receipt": null,
  "source": null,
  "disable_automatic_payment": false,
  "invoice_external_id": "ejemplo-invoice-external-id",
  "status": "UNPAID",
  "paid_amount": 200.0000,
  "expiration_date": "2025-03-10T03:00:00Z",
  "expiration_action": "EXPIRE"

}