invoice.created
Invoice created (invoice.created). Sent to an installation granted read_invoices.
Authorizations
Section titled "Authorizations"Parameters
Section titled "Parameters"Header Parameters
Section titled "Header Parameters"The message id, the same on every attempt: deduplicate on it.
Seconds since the epoch at this attempt; refuse one too far from now.
v1, + base64 HMAC-SHA256 of {webhook-id}.{webhook-timestamp}.{body} with the signing secret (Standard Webhooks).
Request Bodyrequired
Section titled "Request Bodyrequired"object
The webhook type.
When the event happened, UTC with six fractional digits (2026-11-13T09:30:00.123456Z).
The organization it happened in (org_...).
object
The invoice’s public id (inv_...).
The order it was issued for (ord_...); null once that order is deleted.
invoice, or storno: the credit note reversing an invoice in full (negative totals and quantities). New values may appear: treat one you do not know as such.
For a storno, the invoice it reverses (inv_...); null for an invoice.
pending (asked, waiting its turn), submitting (the invoicing software is being asked now),
failed (refused or never sent, see error_code; may be asked again), needs_attention
(outcome unknown: a document may exist at the vendor, a person checks it in the app),
issued (numbered, final), cancelled (issued, then cancelled at the vendor),
reversed (issued, then reversed by an issued storno), discarded (no document came of it). New values may appear: treat one you do not know as such.
Why it is failed or needs_attention, a stable code: order_refused, account_unavailable, not_supported, credentials_rejected, rate_limited, invalid_data, vendor_rejected, not_sent, outcome_unknown, document_unread. Null in any other status. New codes may appear. New values may appear: treat one you do not know as such.
The code’s meaning, in English; the app shows the merchant the full reason in their language.
The invoicing software’s own words when it answered, as it sent them, in its language: for display only, never to parse.
The series as the invoicing software numbered it (e.g. FCT); null until issued.
The number inside the series, a string with its leading zeros (e.g. 0042); null until issued.
The document’s date, a plain day in the organization’s calendar; until issued, the day it was asked for.
The payment due day; null for a storno or without one.
The invoicing account it goes through (int_...); null once that integration is removed.
ISO 4217.
Whether the lines’ unit prices include tax.
Net (without tax) + tax = total; negative on a storno.
object
object
object
object
The buyer as invoiced, in the v1 address shape (first_name and last_name null: an invoice names the buyer whole; company = the name for a company buyer), plus its fiscal code and trade register number. The seller is the organization itself and is not copied on the invoice.
object
The lines by position, at most 250 (MAX_LINES); lines_count is the full count.
object
New values may appear: treat one you do not know as such.
The product code (the store’s SKU); null without one.
A decimal string, trailing zeros trimmed (2, 1.5); negative on a storno.
With tax when the invoice’s prices_include_tax.
object
A percentage as a decimal string (21.0000 = 21%).
After discounts: net + tax = total.
object
object
object
How many lines the invoice has.
Responses
Section titled "Responses"Gone: no more webhooks are sent to this URL until its partner turns them back on.
Received. Any other answer is retried on the schedule.