Documentation
Guide to Conector Stripe to InvoiceXpress by Betacode: what it does, how it connects Stripe and InvoiceXpress, and how to configure your account to issue Portuguese legal invoices.
1. Purpose
Many businesses charge on Stripe but need valid Portuguese tax documents in InvoiceXpress. The connector fills that gap: it imports Stripe invoices and customers, lets you review tax ID, VAT and details, then creates the document in InvoiceXpress — with human review or automation, per your rules.
It does not replace Stripe or InvoiceXpress: it bridges them, with the web app as the workspace where you configure the account and manage invoices. The Stripe plugin opens that app and shows status in the Dashboard.
2. How it works
The product has three parts that work together:
- Stripe App (plugin) — UI Extension in the Stripe Dashboard. See whether the account is configured and open the web app (secure handoff). Setup happens in the web app.
- Web app — invoice and customer lists, review, IX creation, automation, Service billing, and support tickets. (stripe-ix.betacode.tech)
- API — syncs data, stores credentials per account, processes webhooks and queues (IX creation, backfill, automation).
Typical flow: paid invoice on Stripe → synced in the app → review / adjust VAT → create InvoiceXpress document (manual or automatic) → IX status visible in the list.
3. Configure your account
Follow these steps on first install:
- Install the app
Install from the Stripe Marketplace on the intended Stripe account (test or live). Stripe Marketplace. - Open the plugin
In the Stripe Dashboard, open the app. If setup is not finished, it shows a notice and a button to the web app. - Configure in the web app
Use that button to open the web app and finish the setup wizard: InvoiceXpress account, optional webhook, and issuance rules (automation mode, default VAT, and document state). Until the wizard is complete, the app always opens on it. - Return to the plugin
When setup is complete, the plugin shows the account as ready and the button to open the web app. - Work in the web app
The session stays in the browser — later visits can go straight to the app if you are still signed in. Review and issue invoices there.
You can update InvoiceXpress credentials and rules later in the web app Settings, or repeat the initial setup from there.
4. Test environment
To try the connector before production, use the test environment at dev.stripe-ix.betacode.tech. The production app is at stripe-ix.betacode.tech.
The landing page shows a fixed banner at the top: it is a test environment, not the production app.
How to start
- Open the test environment: dev.stripe-ix.betacode.tech.
- On the landing page, choose Access with Stripe. The button opens the test Marketplace app. After authorization, you return to the test environment. In the Stripe Dashboard, work in test mode. Stripe Marketplace.
- Open the plugin. If setup is not finished, the button opens the wizard in the web app. Finish it with the InvoiceXpress account, the optional webhook, and the issuance rules. Until then, the app always opens on the wizard.
InvoiceXpress has no dev environment. The wizard shows a notice at the top: the account you connect creates invoices directly in InvoiceXpress.
What you can do
- Review Stripe test invoices, adjust VAT, and create the InvoiceXpress document one by one or in bulk.
- Import products from Stripe, set each one's VAT, and create the missing items in InvoiceXpress.
- Check customers' tax ID, address, and VAT regime. Changes are saved to Stripe and InvoiceXpress.
- Choose to review before issuing, issue when the invoice is paid, or issue in a batch once a night.
There is no invoice limit and no billing page. The sidebar reminds you this is a test version and that it should only be used with Stripe's test environment.
5. Using the app
- Invoices — see synced Stripe invoices, InvoiceXpress status, filter and select to create IX documents in bulk or one by one.
- Products — import products from Stripe, set each one's VAT, and create the missing items in InvoiceXpress. Products without their own VAT use the default VAT.
- Customers — check tax ID, address, and VAT regime (standard, exempt, or reverse charge for EU businesses). Changes are saved to Stripe and InvoiceXpress and can be applied to that customer's invoices not yet issued.
- VAT — each line uses, in this order, the change made on the invoice, the customer's regime, the product's VAT, and the default VAT. A 0% rate always requires an exemption reason.
- Ignore / manage — mark invoices not to sync, cancel in IX, or reopen flows as available in the table.
Recommendation: on first use, create a few invoices manually to validate tax ID, addresses and VAT before enabling automation.
6. Automation
In the setup wizard you pick one of three modes, which you can change later in Settings:
- Review before issuing (recommended) — invoices wait in the app until you approve them.
- Issue automatically — each invoice paid on Stripe is created in InvoiceXpress right away, through the webhook.
- Issue every night — the day's invoices are created in a batch, once a night.
You also choose whether the document is left as a draft, finalized, or settled in InvoiceXpress. Automatic creation needs an active subscription; during the trial you create invoices manually.
7. Trial and plans
New accounts start with a trial of 5 InvoiceXpress invoices. After that, choose a monthly or yearly plan on the pricing / billing page. Payment for the Service subscription is via Stripe Checkout / Customer Portal.
Billing your customers stays on Stripe; the subscription here only covers connector usage.
8. Support and more
- Support tickets inside the app (Support menu), when signed in.
- Frequently asked questions
- Public API documentation
- Privacy Policy · Terms of Service
- Betacode