Invoicing Stripe Payments in Portugal: Payments, Subscriptions and Refunds
A Stripe invoice is not a Portuguese tax document. How to turn payments, subscriptions and refunds into certified documents with the right date and total.

Stripe issues invoices and receipts that look impeccable. None of them is a Portuguese tax document. No ATCUD, no series filed with the tax authority, nothing entering your SAF-T file, and Stripe is not certified software.
Selling through Stripe from Portugal always means two layers: the payment, which lives in Stripe, and the tax document, which has to be born in certified software. This guide is about connecting the two without losing anything on the way.
The path of a payment
From Stripe to Certified software: what gets decided on the way.The three ways to charge, and why they matter
Stripe has more than one way to take money, and each carries different information about the sale. That is why poorly built integrations work in one case and fail in another.
| How you charge | What Stripe creates | What that carries |
|---|---|---|
| Payment Link / Checkout | A Session and a PaymentIntent | The buyer and the amount; the lines come from the session |
| Subscription | An Invoice per period, and its payment | Lines, periods and discounts, the richest source |
| Direct API charge | A PaymentIntent on its own | Only the amount: the lines are yours to supply |
A subscription billed monthly brings one Invoice a month, with the right periods. A one-off charge brings none of that. If the integration only knows how to read one of these shapes, half the sales go uninvoiced or come out with a generic line.
The total is whatever was paid
A rule with no exceptions: the document total has to equal what was actually paid.
It sounds obvious and it is where most documents go wrong, because the temptation is to add up the lines and trust the sum. It does not hold: discounts, rounding, coupons, tax calculated by Stripe and currency conversion all make the sum of the lines and the amount charged diverge by cents.
The source of truth is the payment processor, not the arithmetic of the lines. One cent is enough to break bank reconciliation and to cost somebody a morning in January. Stripe's fees do not come off the invoice to the buyer: see who invoices what.
The document date
The invoice date is the payment date, not the date the integration ran.
This matters most for payments that take time: SEPA Direct Debit confirms days after it starts, and invoicing with today's date when the money arrived three days ago puts the sale in the wrong period. At month end, in the wrong month.
Mind the series rule too: a series will not accept a document dated earlier than the last one issued in it. Back-dated invoicing means planning the order of issue.
Foreign currency
You charge in dollars; the Portuguese document has to be in euros, or at least carry the euro amount and the exchange rate used.
The rate is not one you pick: it is the official rate applicable on the date of the transaction, and the ECB reference rate is the usual criterion. Stripe has its own rate for converting what it pays out to you. They are different things and it is normal for them not to match to the cent. The article invoicing in a foreign currency shows the rate the law requires and how each program prints it.
Who the buyer is
Stripe does not always know who bought. A Payment Link with no billing fields gives you an email address and nothing else.
For the tax document, that gets resolved in one of two ways:
- With a VAT number, which the customer has to provide somewhere: a checkout field, the Stripe Customer, or metadata.
- Without one, issuing to a final consumer. If you opt for a simplified invoice, the limit for services is €100 (article 40 of the VAT Code).
What you should not do is invent a customer record from the email and leave it incomplete: the certified software fills up with hundreds of duplicate customers, and correcting the VAT number later means editing the customer record and cancelling and reissuing any document already finalised: see wrong NIF or asked later.
Subscriptions: the cases that break integrations
- The first charge arrives one way and the rest another. Listening only to the checkout session event invoices the first month and loses the rest; listening only to the paid invoice can duplicate the first.
- Trials. A free period produces a €0 invoice. Issuing a €0 tax document is rarely what anyone wants.
- Mid-cycle changes. Upgrades and downgrades produce proration lines, with negative amounts. A negative line is not acceptable in every certified package.
- Invoices with many lines. Stripe does not hand over every line at once: it hands over the first ones and says there are more. An integration that does not fetch the rest issues incomplete invoices, and the total stops matching.
Refunds
A refund in Stripe returns money and undoes no document. On the tax side you need a credit note:
- Partial refund: the credit note carries the returned lines.
- Full refund: it mirrors the whole document.
If the refund arrives before the sale is invoiced, the money still came in: you issue the invoice for the amount received and then the credit note. The full path is in From refund to credit note.
Stripe Tax
Stripe Tax calculates tax by country and solves much of the rate problem. It does not solve the rest: it still does not issue a certified document, it does not handle the Portuguese exemption code, and it does not do the VIES validation on sales to businesses on the document side.
And there is a detail that bites: if Stripe Tax is switched off, payments arrive with no tax at all. Your integration then has to decide the rate, and an integration that assumes "tax always comes with it" issues everything at 0% without raising a single error. See what Stripe Tax solves and what it does not.
How Rioko helps
Rioko listens to Stripe's events and treats the three ways of charging the same way: one-off payment, checkout session and subscription invoice all come down the same path and come out as a certified document in InvoiceXpress, Moloni, Moloni ON, Vendus or TOConline.
What is in there because it hurt at some point:
- The total comes from the payment, always, and issuing is refused when it does not match what was about to be issued.
- The date is the payment date, including on SEPA, where the gap is days.
- The lines are paginated to the last one, even when a Stripe invoice has dozens.
- A payment is invoiced once, even with repeated events, and Stripe does repeat them.
- Always in euros, with the amount received, the currency and the exchange rate shown on the invoice.
If you also sell through a shop, the path is the same: Invoicing Shopify orders in Portugal. If you invoice in Moloni, what changes is in Invoicing Stripe payments in Moloni. If you take payments by Multibanco or MB WAY, Rioko also connects to Easypay and EuPago: see From Easypay payment to invoice and Multibanco and MB WAY with EuPago.
See how it works with Stripe → · Pricing
If a payment ends up without an invoice, see what stops an invoice going out. Before you automate, read what changes between draft and finalised.
If you provide services to businesses, also read the article on withholding tax.
Sources
Frequently asked questions
Is a Stripe invoice a valid tax document in Portugal?
No. Stripe is not certified software: there is no ATCUD and no filed series, and the document never enters your SAF-T file.
What total does the invoice have to carry?
Whatever the person actually paid, always. Discounts, coupons and currency conversion make the sum of the lines diverge from the amount charged: the payment processor is the source of truth.
What date does the document carry?
The payment date, not the day the integration ran. With SEPA the gap is days, and at month end it changes the period.
Do I need to issue an invoice for every monthly charge?
Yes. Each subscription charge is a sale and needs its own document, with the payment date.
How are subscriptions invoiced?
From the invoice Stripe creates each period, which carries lines and dates. The first charge can arrive by a different route, and an integration that listens to only one event either misses months or duplicates the first.
How do I collect the VAT number on a Payment Link?
Turn on tax ID collection in Stripe Checkout, or ask for it in a custom field and store it on the Customer or in the metadata. With no VAT number, the invoice goes out to a final consumer.
Which document do I issue for a €150 service with no VAT number?
An invoice or invoice-receipt to a final consumer. A simplified invoice for services can only go up to €100, under article 40 of the Portuguese VAT Code.
I charge in dollars. How does the invoice come out?
The Portuguese document has to show the amount in euros and the exchange rate applied. Stripe's exchange rate is a different one, and it is normal for it not to match what Stripe pays out to the cent.
How is a partial refund invoiced?
With a credit note carrying only the returned lines, in its own series. A full refund mirrors the whole document.
Does Stripe Tax solve VAT?
It solves the rate, not the document. It still does not issue a certified document, and it does not handle the Portuguese exemption code or the VIES validation on sales to businesses. And if it is switched off, payments arrive with no tax at all.
Still have questions
Write the question. It reaches a person, not a form.




