Invoices
Webhook event
invoice.created
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.
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.created"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.updatedSent when an invoice is replaced, when its payment status changes (including a Stripe payment), or after any other save.
- EVENTinvoice.deletedSent when a finalized invoice is deleted.
- Webhooks guideSubscribe, verify the signature, handle retries
Download the invoice PDF GET
Streams the invoice PDF. If the PDF is not ready yet, the request waits up to 20 seconds for it and then fails with 500. Content-Length is not sent.
invoice.updated Webhook
Sent when an invoice is replaced, when its payment status changes (including a Stripe payment), or after any other save. 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.