Invoices
Webhook event
invoice.updated
Sent when an invoice is replaced, when its payment status changes (including a Stripe payment), or after any other save.
2XXReturn any 2xx status to acknowledge the delivery. Any other status or a timeout schedules a retry.
- Attempt 1: Now
- Attempt 2: +10 s
- Attempt 3: +100 s
After 3 failures, the delivery is dropped. Deliveries can repeat and arrive out of order. Make your handler idempotent.
Lowercase hex HMAC-SHA256 of the raw request body, keyed with the webhook subscription's signing secret (whsec_…). Recompute it over the exact bytes received and compare with a constant-time function before trusting the payload. No timestamp or event-id header is sent.
Payload attributes
{ event, data } · 60 attributes
eventstringAlways"invoice.updated"dataInvoiceidstring (uuid)e.g."9c1e2d3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f"business_idstring (uuid)e.g."3f7a1c2e-5b6d-4e8f-9a0b-1c2d3e4f5a6b"invoice_typeInvoiceTypee.g."vat_invoice"The three
*vat_invoicetypes requirevat_percentageon every line and, whenselleris sent,seller.vat_code.One ofregular_invoicevat_invoicepreliminary_invoicepreliminary_vat_invoicecredit_invoicecredit_vat_invoiceseriesstringe.g."PVZ"invoice_numberstringe.g."012"Zero-padded to three digits, e.g.
"007". Send it back padded or unpadded on update; both are accepted.invoice_datestring (date)e.g."2026-03-02"Issue date,
Y-m-d.pay_until_datestring (date)nullablee.g."2026-03-16"Due date,
Y-m-d.languageInvoiceLanguagee.g."lt"Language of the PDF and the public share page.
One ofenltesdefrplsubtotalnumbere.g.200Sum of the lines excluding VAT.
vatnumbere.g.42total_incl_vatnumbere.g.242currencystringe.g."EUR"payment_statusPaymentStatuse.g."not_paid"One ofnot_paidpaidnotesstringnullablee.g."Apmokėti per 14 dienų."share_linkstring (uri)e.g."https://beta.fsaskaita.lt/invoice/share/7e4a9b2c-3d1f-4a5e-b6c7-d8e9f0a1b2c3"Public link to the invoice; anyone with the link can view it.
sellerobjectbuyerobjectitemsarray of InvoiceItempayment_optionsarray of PaymentOptioncreated_atintegere.g.1772435700Unix timestamp, seconds.
updated_atintegere.g.1772435700Unix timestamp, seconds.
Related
- RetriesDeliveries can arrive more than once and out of order; make the handler idempotent.
- Verify the signatureCheck the
Signatureheader against the raw body before trusting the payload. - GET/invoices/{invoice}Fetch the current state of the invoice
- EVENTinvoice.createdSent when a finalized invoice is created, whether through the API, the app or a recurring invoice.
- EVENTinvoice.deletedSent when a finalized invoice is deleted.
- Webhooks guideSubscribe, verify the signature, handle retries
invoice.created Webhook
Sent when a finalized invoice is created, whether through the API, the app or a recurring invoice. The PDF is rendered asynchronously, so it may not exist yet when this event arrives; GET /invoices/{invoice}/download waits up to 20 seconds for it. Each event is attempted up to 3 times: the first delivery, then retries after 10 s and 100 s; only a 2xx response counts as success. The request times out after 10 seconds.
invoice.deleted Webhook
Sent when a finalized invoice is deleted. The payload contains only the id of the deleted invoice. Each event is attempted up to 3 times: the first delivery, then retries after 10 s and 100 s; only a 2xx response counts as success. The request times out after 10 seconds.