Corrections (KOR)
A Stripe credit note is filed to KSeF as an FA(3) correction invoice of type KOR, referencing the original's KSeF number.
How it works
- You issue a credit note in Stripe against an invoice.
- We receive the webhook and create a correction linked to the original invoice. If the original hasn't been ingested yet (Stripe delivers events out of order), we return a non-2xx response so Stripe retries — the correction is never lost.
- We map the credit note to an FA(3) KOR. Amounts are negative (it's a reduction). In the correction section we cite the corrected invoice's reference: its KSeF number, number, and issue date.
- We file it to KSeF exactly like an invoice.
- Write-back of the correction's KSeF number onto the credit note: into
metadata(machine-readable) andmemo(human-visible).
Any Stripe discounts or coupons are already reflected in the filed net amounts, so what we report to KSeF matches what the customer was actually charged.
Requirement
A correction must reference the original's KSeF number. So the original invoice must be accepted by KSeF first — only then does it have a KSeF number to cite.
Chargebacks & refunds — not the same thing
A KOR documents a change to the sale (a reduced price, a return, a cancellation) — under art. 29a of the VAT Act. A chargeback is a payment dispute at the card/bank level; on its own it does not change the sale, so it is not automatically a KOR. We never auto-file a correction off a Stripe dispute event — a KOR follows only from a credit note you issue, which is a deliberate accounting decision. What's correct depends on the cause:
- You refund / accept the return (the sale really is reduced or undone) → issue a credit note in Stripe → we file a KOR. This is the normal path above.
- The sale stands but the payment was clawed back (e.g. card fraud, an unjustified dispute) → the invoice remains valid and you do not issue a KOR — the supply still happened. The VAT you already reported stays due. An unrecovered amount may later qualify for bad-debt relief ("ulga na złe długi", art. 89a) — a separate mechanism with its own statutory waiting period, not a correction. That path is on our roadmap, advisor-gated; today it is handled outside the app.
Voided and uncollectible invoices
An invoice KSeF has accepted cannot be withdrawn or deleted. Voiding it in Stripe, or marking it uncollectible, changes nothing in KSeF. We file a correction only from a credit note. An invoice or credit note voided before we sent it is different: we don't file it at all (see How filing works).
- Instead of voiding a filed invoice, issue a credit note against it. Stripe accepts a credit note on an open, paid or uncollectible invoice, and we file it as a KOR. A credit note for the full amount of an open invoice closes it in Stripe: the amount due drops to zero and the status changes to paid.
- An invoice already voided takes no credit note in Stripe. File the correction yourself then, for example in the KSeF taxpayer app (
https://ap.ksef.mf.gov.pl), citing the original's KSeF number. You'll find the number in the panel and in the invoice'smetadataunderksef_number. We don't know about a correction filed by hand, so on our side the invoice keeps showing as filed. - Non-payment alone does not call for a correction. If the service was delivered, the invoice stays valid, and the unrecovered VAT may qualify for the bad-debt relief described above. Whether to correct is a decision for you and your accountant.
See also How filing works.