Overview
Connect your Stripe account with BeeL. to issue an invoice automatically for every payment.
At a glance
| What it does | Issues an invoice in BeeL. every time you receive a payment in Stripe |
| How it connects | Via Stripe Connect (OAuth) |
| What you need | A Stripe account and an active BeeL. subscription |
| What you should know | Stripe's own invoices are not issued through BeeL.: turn them into proformas so your customers receive one invoice |
How does it work?
BeeL. connects to your Stripe account using Stripe Connect. This means you authorize BeeL. to receive notifications about your payments, without sharing your API keys or sensitive data.
The flow is simple
- Your customer pays in Stripe (subscription, one-time payment, anything)
- Stripe notifies BeeL automatically via a webhook
- BeeL. issues the invoice, mirroring the Stripe charge exactly — see Data conversion
- BeeL. submits its billing record to AEAT (VeriFactu) if it is enabled for the NIF
- Your customer receives the invoice by email (if enabled)
You don't have to do anything per payment. Just connect and configure once.
Refunds and credit notes generate corrective invoices automatically. BeeL. maps Stripe's reason to one of R1–R5 — see Generated invoices.
What does this mean for my customers?
This is important and we want to be transparent:
Stripe invoices and BeeL. invoices are different things. Stripe generates its own payment documents; they are not issued through BeeL., so they carry no number from your BeeL. series, no billing record and no VeriFactu QR.
To avoid confusion, we recommend configuring Stripe invoices as proforma and disabling their invoicing emails. That way your customers only receive the invoice issued through BeeL.
The downside is that your customers won't be able to see invoices in the Stripe portal. This is a current limitation — the invoices issued through BeeL. are in BeeL., not in Stripe. We're working to improve this experience.
Initial setup
- Go to Settings > Integrations in BeeL
- Click Connect on the Stripe card
- Authorize the connection with your Stripe account (Stripe Connect opens)
- Open the Stripe configuration and choose your invoice series, whether to send emails, etc.
- In Live mode, switch on auto-invoicing for the connection. A Live connection starts with it off, so charges are not invoiced until you do — see Connection settings. In Test mode it starts on.
Once auto-invoicing is on, every payment generates an invoice automatically. A payment whose data is not enough to invoice it waits in Needs attention with the reason — see Edge cases and limits.
Managing several NIFs (agencies & fleets)? Connect Stripe per NIF over the API — white-label, from your own portal — instead of the dashboard flow above. Each company (owned or managed) gets its own connection so charges are auto-invoiced under the right NIF. See Connect Stripe for the connect · list · disconnect endpoints.
Setup guides
Configure Proforma Invoices in Stripe
How to disable Stripe invoices so your customers receive one invoice per payment.
How Taxes Are Applied
Fiscal Mirror rule — BeeL. reflects Stripe's tax breakdown exactly, with a clean fallback when Stripe Tax isn't enabled.
Connection settings
Every per-connection setting — auto-invoicing, customer creation, email delivery.
How it works
Supported Stripe events
Which events BeeL. listens to, which create invoices, and which are explicitly ignored.
What invoice gets generated
The F1 vs F2 decision tree, the refund → R1–R5 mapping, and series resolution.
Data conversion
Field-by-field mapping from Stripe payload to BeeL. invoice, with the Fiscal Mirror rule explained.
Customer mappings
How BeeL. matches Stripe customers to BeeL. customers and creates ad-hoc records when needed.
VeriFactu submission
Why AEAT submission is decided by the issuing NIF, not by the connection.