Support
Everything you need to get started and troubleshoot LusoInvoice.
Getting Started
1. Install the app
Install LusoInvoice from the Stripe App Marketplace. The app will appear in your Stripe Dashboard sidebar.
2. Connect InvoiceXpress
Open the LusoInvoice panel from the Dashboard Home. Enter your InvoiceXpress account subdomain and API key. Click "Validate & Continue" — credentials are verified and securely stored in the Stripe Secret Store.
3. Enable the webhook
In Step 2 of the setup, click "Enable Integration". This creates a webhook that listens for completed payments to enable auto-sync.
4. Configure your settings
Go to Settings to choose your document type (Invoice, Invoice-Receipt, or Simplified Invoice), set the InvoiceXpress sequence, withholding tax, VAT exemption, default VAT rate, and enable or disable auto-sync.
Frequently Asked Questions
How do I find my InvoiceXpress API key?
Log in to your InvoiceXpress account. Go to Settings → API and copy the API key. Your account subdomain is the part before .app.invoicexpress.com in your InvoiceXpress URL.
How do I sync a payment manually?
Navigate to Payments in the Stripe Dashboard and select a completed payment. The LusoInvoice panel on the right shows the payment details and line items. Click "Create Invoice" to generate the document in InvoiceXpress. A link to the invoice appears after sync.
How does auto-sync work?
When enabled in Settings, auto-sync listens for the payment_intent.succeeded webhook event. Each time a payment completes, LusoInvoice automatically creates the corresponding document in InvoiceXpress. The system checks for duplicates to prevent creating the same invoice twice.
How do I link Stripe customers to InvoiceXpress?
Go to Customers in the Stripe Dashboard and select a customer. LusoInvoice automatically searches for matching InvoiceXpress customers by name and code. Accept the suggested match or search manually. Once linked, invoices will include the customer's InvoiceXpress details.
What document types are supported?
LusoInvoice supports three Portuguese document types: Invoice (Fatura), Invoice-Receipt (Fatura-Recibo), and Simplified Invoice (Fatura Simplificada). You can choose the default type in Settings.
How are taxes (VAT) handled?
LusoInvoice automatically extracts tax information from Stripe (including tax rates, Stripe Tax, and default tax rates) and maps them to InvoiceXpress tax codes. It correctly handles tax-inclusive and tax-exclusive pricing. You can also set a default VAT rate or a VAT exemption code (M01-M99) in Settings.
How do I disconnect InvoiceXpress?
Go to Settings and click "Disconnect InvoiceXpress". This removes the webhook, deletes customer links and settings, and returns the app to the onboarding screen. Synchronization logs are preserved as historical records.
Does it work with Stripe test mode?
Yes. All features work in Stripe test mode. Note that InvoiceXpress does not have a test mode — documents will be created in your real InvoiceXpress account (they can be voided afterwards).
Contact Us
Can't find what you're looking for? Reach out and we'll help you get set up.
Email us at lusoinvoice@alemdocodigo.pt