Payload

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

invoiceIdstring

The invoice ID.

invoiceNumberstring

The human-readable invoice number.

invoiceStatusstring

Always "void" for this event.

periodStartstring | null

ISO 8601 start of the billing period.

periodEndstring | null

ISO 8601 end of the billing period.

issueDatestring | null

ISO 8601 date the invoice was issued.

dueDatestring | null

ISO 8601 date the invoice was due.

currencystring

The invoice currency code.

subtotalnumber

Subtotal in cents (100 = $1.00).

totalnumber

Total in cents (100 = $1.00).

customerIdstring

The customer ID. Returns your externalId if you provided one when creating the customer, otherwise returns the Commet publicId.

subscriptionIdstring | null

The subscription ID, if the invoice is linked to a subscription.

{
  "event": "invoice.voided",
  "timestamp": "2026-04-26T10:00:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-05-25",
  "data": {
    "invoiceId": "inv_n4o5p6",
    "invoiceNumber": "INV-0043",
    "invoiceStatus": "void",
    "periodStart": "2026-04-25T00:00:00.000Z",
    "periodEnd": "2026-05-25T00:00:00.000Z",
    "issueDate": "2026-04-25T00:00:00.000Z",
    "dueDate": "2026-04-25T00:00:00.000Z",
    "currency": "usd",
    "subtotal": 9900,
    "total": 9900,
    "customerId": "user_123",
    "subscriptionId": "sub_1a2b3c4d"
  }
}

Cuándo se dispara

Un recibo se anula cuando se invalida antes de su cobro: un administrador lo marca como anulado a través del dashboard o la API, o Commet anula automáticamente los recibos impagos cuando se cancela su suscripción. La anulación es terminal — un recibo anulado nunca se reintenta ni se cobra.

El payload tiene la misma forma de recurso de recibo que invoice.created, con invoiceStatus establecido en "void".

Usa este evento para revertir cualquier cosa que hayas activado a partir de invoice.created para este recibo — recordatorios de dunning pendientes, asientos contables o banners en la app sobre un recibo abierto.