How to connect Stripe and InvoiceXpress faster
A practical guide to configure LusoInvoice, validate credentials, and start issuing Portuguese documents from Stripe Dashboard.
Integration prerequisites
Before setup, confirm admin-level access in both Stripe and InvoiceXpress. This avoids interruptions during onboarding.
You should also confirm the default document type and make sure the target InvoiceXpress sequence is active.
- Stripe account with app installation permissions.
- InvoiceXpress account with active API key.
- Baseline tax settings already defined.
Step-by-step configuration flow
Install LusoInvoice from Stripe App Marketplace and open the app panel in your Dashboard. Then enter your InvoiceXpress subdomain and API key.
After validating credentials, enable webhook sync and configure issuance rules such as document type, sequence, and tax defaults.
- Validate credentials with the setup flow.
- Enable webhook integration for completed payment events.
- Review settings before enabling production automation.
Post-setup quality checklist
Run a test payment in Stripe test mode and confirm correct document creation and customer linkage.
Monitor synchronization logs in the first production days to quickly detect tax, sequence, or mapping mismatches.
- Confirm no duplicate documents for the same payment.
- Validate net amount, VAT, and total on emitted documents.
- Verify customer mapping between Stripe and InvoiceXpress.
Quick FAQ
Can I start with manual sync only?
Yes. You can issue documents manually first and enable webhook automation later.
Do I need to change Stripe Checkout?
Usually no. You mainly need complete customer and tax data on payments.