In this guide, you’ll learn how to connect Stripe with Invopop to automatically generate tax-compliant invoices and credit notes, from your Stripe dashboard.The Stripe integration consists of two components:
An Invopop app within your Stripe dashboard
An app in your Invopop console
When a Stripe invoice or credit note reaches the finalized status, our integration will automatically create a new job in your selected Invopop workflow.
Track invoice status directly in your Stripe dashboard
The job will extract the invoice data from Stripe and execute the actions, such as converting it to any e-invoice format and submitting it to your local tax authority.
Before you begin, ensure you have an active Stripe account.
1
Install Invopop in Stripe
Navigate to the Invopop app in Stripe’s App Marketplace and click Install.
Next, Stripe will prompt you to select the Stripe environment you’d like to connect to, you can start with test mode or sandbox and switch to live later.
Install Invopop in Stripe
2
Connect Stripe to Invopop
After installation, you should be redirected to your Stripe dashboard and see the Invopop app in the right sidebar. Alternatively, just open the Invopop app in your Stripe dashboard.Click Connect Invopop. The next page will ask you to login to your Invopop account. If you’re new to Invopop, the connection process will guide you through creating your Invopop account and setting up your first workspace.
When connecting a test or sandbox environment in Stripe, select a sandbox workspace in Invopop. For live environments, select a live workspace.
Connect your Invopop account
3
Select a workspace
After connecting your Invopop account to Stripe, you’ll be redirected back to Stripe to choose the workspace where you want to process your invoices.
Choose your workspace
4
Configure your workflow
Select or create a workflow to process your invoices and credit notes.To use an existing workflow select it from the Stripe’s sidebar menu and click Save WorkflowTo create a new workflow click on Create New Workflow in the sidebar menu. You’ll be redirected to Invopop.Start from the basic template below, then add the steps your country requires — see Country workflows.This workflow syncs with Stripe, signs the invoice and generates a PDF.
By default, Stripe does not display your tax ID on invoices. To enable it, go to Settings > Billing > Invoices. In the Invoice Tax Information section, enter your tax ID, set it as the default, and click Save.
Each country needs its own steps between the Stripe import and the send. Two things are worth knowing before you pick one:
Your tax ID must reach the invoice. Stripe only attaches your account tax ID when you set it as the default (see Show your tax ID on invoices). Without it, country steps fail with errors such as supplier SIREN is required for B2B local invoices.
The regime comes from the supplier’s tax ID country. A workflow step for one country rejects invoices from another — see the FAQ on unexpected tax regime errors.
Europe (Peppol)
This workflow sends each invoice over the Peppol network, the route Belgian, Dutch and Nordic customers receive invoices on. It looks the customer’s participant ID up on the network at run time, and reshapes the parts of a Stripe invoice that Peppol validation rejects: negative line items become discounts, a missing purchase order code becomes NA, and card payment instructions get payment terms. Your supplier must be registered on Peppol first — see the Peppol guide.
France routes each invoice on whether the customer is registered in the PPF directory. This workflow imports the Stripe invoice, adds the billing mode and VAT exemption codes France requires, then looks the customer up: registered customers get a Peppol France CIUS document recorded and forwarded to the PPF, and everyone else is recorded for e-reporting instead, then sent over Peppol if they have an inbox.
Workflow
Code
There is no one-click template for this workflow yet. Copy and paste it into a new Empty Invoice workflow code view.
This workflow issues a VERI*FACTU invoice for each finalized Stripe sale: it adds the es-verifactu-v1 addon, signs the invoice, submits it to the AEAT and generates the PDF.
After setup, finalized Stripe invoices are imported into Invopop automatically and saved to the Sales folder. Use the steps below to verify status, review details, retry processing, and import historical invoices.
1
Check invoice status in Stripe
Open the invoice in Stripe and check the Invopop panel in the right sidebar to confirm whether processing succeeded.
Invoice processed successfully in Stripe
2
Check invoice status in Invopop
In the Invopop console, go to Sales and open the invoice to view its status. To review the underlying processing job, go to Workflows > History and open the job details.
Job details in Invopop
3
Troubleshoot import errors
If an invoice fails, it is usually one of two cases:
The invoice was not imported into Invopop because converting from Stripe to Invopop failed. Update the data in Stripe and click Retry in the Invopop panel.
Retry invoice
The invoice was imported into Invopop but submission to the tax authority failed. Correct the invoice in Invopop and re-run a workflow that omits the Import invoice from Stripe step to avoid reimporting the original data. Typical causes include missing required fields or invalid field formats.
Incorrect invoice details
4
Get notified of failures
Add a notification action in your workflow’s Error Handling section—Slack, email, or webhook—so you’re alerted when an import fails.
If you need help tailoring a workflow to your use case, contact us at support@invopop.com.
How can I add a Purchase Order number to the invoice?
Stripe does not include a dedicated Purchase Order field on invoices. Add it as a custom field named PO Number.You can add the custom field in any of these places:
The specific invoice
The subscription
An invoice template
Can I import historical invoices (issued before I connected Invopop)?
Yes. Open the invoice in Stripe and click Process this invoice in the Invopop panel (right sidebar).Note: The invoice issue date will be set to the sync date (today), as required by tax agencies. The operation date remains the original date of the transaction.
Import historic invoices
Can I import invoices when paid instead of when finalized?
Yes. You can import on payment instead of on finalization. Update the invoice import trigger in either Stripe or Invopop:Option 1: In Stripe
In “Invoice Import Trigger”, select “When Paid” (instead of “When Finalized”).
Click Save Changes.
Update invoice import trigger in Stripe
Option 2: In Invopop
Go to Configuration > Apps > Stripe > Configure.
Click Update Settings.
In “Invoice import trigger”, select “When Paid” (instead of “When Finalized”).
Click Save.
Update invoice import trigger
Note: This applies to invoices from now on; it does not change past imports.
I get an "access denied: unexpected tax regime" error when processing invoices
This error means the invoice’s tax regime does not match the one expected by the workflow step. For example, VERI*FACTU requires a Spanish regime and KSeF requires a Polish regime. The regime is automatically determined by the supplier’s tax ID country.The most common cause is that the supplier’s tax ID is missing from the invoice. To fix this, make sure you have completed Step 5 of the setup: go to Settings > Billing > Invoices, enter your tax ID, and set it as the default. Stripe does not automatically include your account tax ID on invoices.Once the tax ID is set as default, it will appear on new invoices and the error should disappear.
Participate in our community
Ask and answer questions about Stripe integration →
