Overview
Connect your Stripe account with BeeL to automatically generate official invoices with every payment.
At a Glance
| What it does | Generates an official 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 invoices are not the official ones — BeeL invoices are (VeriFactu compliant) |
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 generates the official invoice, mirroring the Stripe charge exactly — see Data conversion
- BeeL submits the invoice to AEAT (VeriFactu) if you have it enabled
- 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, but they don't comply with Spanish tax regulations (VeriFactu). The official invoices are the ones generated by BeeL.
To avoid confusion, we recommend configuring Stripe invoices as proforma and disabling their invoicing emails. That way your customers only receive the official invoices from BeeL.
The downside is that your customers won't be able to see invoices in the Stripe portal. This is a current limitation — official invoices are in BeeL, not in Stripe. We're working to improve this experience, but for now it's the only way to ensure invoices are VeriFactu compliant.
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.
That's it. From that point on, every payment generates an invoice automatically.
Setup guides
Configure Proforma Invoices in Stripe
How to disable Stripe invoices so they don't interfere with the official ones from BeeL.
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 — simplified threshold, auto-submit, 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
The per-connection auto-submit toggle and how AEAT submission gating works for Stripe invoices.