invoice.voided
Triggered when an invoice is voided, by hand or automatically.
X-Clocknext-Signature*stringt=<unix seconds>,v1=<hex HMAC-SHA256> — the HMAC of ${t}.${rawBody} keyed with the endpoint's signing secret. See Verify the signature.
X-Clocknext-Event-Id*stringThe event's id — the same as id in the body, and the same on every retry.
X-Clocknext-Event-Type*stringThe event name — the same as event_type in the body.
application/json- body
id*stringevt_ + 32 hex characters. Unique per event, and the same on every retry of it — use it to skip duplicates.
event_type*stringAlways invoice.voided.
triggered_at*stringWhen the event was triggered (ISO 8601).
date-timedata*The customer and the invoice, as it is after the change.
Answer any 2xx within 5 seconds; the body is ignored. Anything else counts as failed and is retried.
{ "id": "evt_7863bea7d393cdcf4ce935e29c35b56b", "event_type": "invoice.voided", "triggered_at": "2026-11-08T00:00:05.133Z", "data": { "customer": { "id": "cus_abc123", "name": "Acme Corp" }, "invoice": { "id": "inv_def456", "number": "INV-0042", "status": "VOID", "subscription_id": "pur_ghi789", "plan_name": "Growth", "billing_mode": "ADVANCE", "cycle_index": 1, "subtotal": 100, "tax_amount": 18, "amount": 118, "currency_code": "usd", "display_amount": 118, "display_currency_code": "usd", "issued_at": "2026-11-01T00:00:00.000Z", "paid_at": null, "voided_at": "2026-11-08T00:00:05.000Z" } }}{ "X-Clocknext-Signature": "t=1791367200,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd", "X-Clocknext-Event-Id": "evt_7863bea7d393cdcf4ce935e29c35b56b", "X-Clocknext-Event-Type": "invoice.voided"}Types
Every object type on this page, with its fields.
InvoiceVoidedEvent
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | evt_ + 32 hex characters. Unique per event, and the same on every retry of it — use it to skip duplicates. |
event_type | string | yes | Always invoice.voided. |
triggered_at | string | yes | When the event was triggered (ISO 8601). |
data | InvoiceEventData | yes | The customer and the invoice, as it is after the change. |
InvoiceEventData
The data object of an invoice.created, invoice.paid or invoice.voided event: the customer and the invoice, as it is after the change.
| Field | Type | Required | Description |
|---|---|---|---|
customer | WebhookCustomer | yes | The customer the event is about. |
invoice | WebhookInvoice | yes | The invoice when the event is triggered. |
WebhookCustomer
The customer the event is about.
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | The customer's Clocknext id. |
name | string | yes | The customer's name. |
WebhookInvoice
The invoice when the event is triggered. Amounts are USD.
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | The invoice's id. |
number | string | yes | The invoice's number. |
status | "OPEN" | "PAID" | "VOID" | "AUTO_CLOSED" | yes | OPEN, PAID, VOID or AUTO_CLOSED. |
subscription_id | string | null | yes | The subscription the invoice bills — subscription.id in the subscription events. |
plan_name | string | yes | The plan's name. |
billing_mode | "ADVANCE" | "ARREAR" | yes | ADVANCE — billed at the start of the period. ARREAR — billed for usage at its end. |
cycle_index | integer | yes | The billing period the invoice covers. 0 is the first. |
subtotal | number | yes | The total before tax, in USD. |
tax_amount | number | yes | The tax, in USD. |
amount | number | yes | The total, in USD. |
currency_code | string | yes | Always usd — subtotal, tax_amount and amount are in USD. |
display_amount | number | yes | The same as amount, in USD (Clocknext converts no money). |
display_currency_code | string | yes | Always usd. |
issued_at | string | yes | When the invoice was issued (ISO 8601). |
paid_at | string | null | yes | When it was paid. Null until then. |
voided_at | string | null | yes | When it was voided. Null unless it was. |