Invoices and managing your subscription
View your invoices, change your plan, and cancel an active subscription from the Billing tab of Account settings. Every control here calls a server route that keeps your billing record in sync.
How-to guide.
Manage your plan, payment method, and invoices from one place: the Facturation (Billing) tab of Account settings. This guide covers the three flows that are wired end to end in the workspace: viewing invoices, changing your plan, and cancelling an active subscription.
Open the Billing tab
Billing lives in Account settings, not in your project settings.
- In the workspace, open the user menu and choose Paramètres de compte (Account settings).
- In the settings dialog, select the Facturation tab from the left sidebar.
The tab loads three things in the background: your current plan and renewal date, your invoice history, and your saved payment method. While it loads you see a spinner; once ready, every section below is on this one tab.
What you see if you have no subscription
The Plan actuel (Current plan) row reads Free with the subtitle Aucun abonnement actif (No active subscription). The payment-method row shows Aucun moyen de paiement (No payment method), and the cancel control is hidden. You add a payment method by subscribing to a plan.
View your invoices
The Historique des factures (Invoice history) section lists your subscription charges and credit top-up purchases together, newest first. It loads from GET /api/billing/invoices when the tab opens.
Each row shows four things:
- Type: Abonnement (a monthly Pro or Max charge) or Recharge crédits (a one-off credit top-up).
- Date: formatted in your account locale (for example
5 Jun 2026). - Total: the amount charged, such as
$20.00. - Status: Payée (paid), En attente (pending), or Échec (failed).
Where the upstream receipt or invoice document exists, the row ends with a Voir (View) link that opens it in a new tab. The list shows up to 30 rows. If you have no invoices yet, the section reads Aucune facture (No invoice).
The receipt itself opens off MaShop
MaShop lists the invoice; the downloadable receipt or invoice document is served by the payment provider that processed the charge. The Voir link points there. If a row has no link, the receipt is not available for that charge.
Change your plan
Use this flow to upgrade, downgrade, or move between Free, Pro, and Max.
- In the Plan actuel (Current plan) row, click Modifier (Change).
- The Modifier l'abonnement dialog shows the three plans side by side. Select the one you want.
- Confirm with the button at the bottom. Its label changes to match your choice.
The three plans and their monthly credit allocation:
| Plan | Price | Monthly credits |
|---|---|---|
| Free | $0 / month | Pay as you go (no monthly allocation) |
| Pro | $20 / month | 2,000 credits per month |
| Max | $100 / month | 12,000 credits per month |
The confirm button tells you exactly what will happen:
- Picking a higher plan reads Passer à Pro or Passer à Max (Switch to).
- Picking a lower paid plan reads Rétrograder vers (Downgrade to) and shows a warning banner.
- Picking Free reads Annuler l'abonnement (Cancel subscription) and routes into the cancel flow below.
- If you select the plan you already have, the button is disabled and reads Plan actuel (Current plan).
What a downgrade forfeits
When you move to a smaller plan, the dialog warns that your unused monthly subscription credits are lost at the end of the current period and already-spent credits are not refunded. Credits you bought as top-ups are not affected. When you have subscription credits left, the banner quotes the exact number you will forfeit.
For the full breakdown of what each plan includes, see Plans. For how credits are spent and topped up, see Credits and Top-ups.
Cancel your subscription
Cancellation is scheduled for the end of the current billing period. You keep access to your paid plan until that date; you are not cut off immediately and the current period is not refunded.
There are two ways to reach the cancel confirmation, both on the Billing tab and both shown only while you have an active paid plan:
- The red Annuler l'abonnement (Cancel subscription) row near the bottom of the tab has an Annuler (Cancel) button.
- Inside the Modifier l'abonnement dialog, selecting Free and confirming opens the same prompt.
The confirmation dialog is titled Annuler votre abonnement ? and explains that the subscription ends at the end of the current period. Click Confirmer l'annulation (Confirm cancellation) to proceed. The button shows Annulation… while the request runs.
Behind the button, this calls POST /api/billing/cancel-subscription. The route marks your subscription to cancel at period end and tells the payment provider to do the same.
What success looks like
On success you see a confirmation toast: Annulation programmée à la fin de la période en cours (Cancellation scheduled for the end of the current period). The plan keeps working until the period ends.
Cancellation errors you may see
The cancel route returns a plain message when it cannot proceed:
| Message | Meaning |
|---|---|
| Aucun abonnement actif trouvé. | No active subscription was found on your account, so there is nothing to cancel. |
| L'annulation est déjà programmée. | You already scheduled this cancellation; it is pending at period end. |
| Trop de requêtes. | You hit the rate limit. The cancel endpoint allows up to 5 requests per minute. Wait a moment and retry. |
Reversing a cancellation is not self-serve
The Billing tab has no button to undo a scheduled cancellation. To keep a subscription you have already scheduled to cancel, or to cancel immediately instead of at period end, contact support rather than looking for a control in the workspace.
Update your payment method
While you have an active subscription, the Méthode de paiement (Payment method) row shows your saved card, for example Visa •••• 4242. Click Mettre à jour (Update) to open your provider's customer portal in a new tab, where you change the card on file. This loads from GET /api/billing/customer-portal; that endpoint allows up to 10 requests per minute.
If you have no active subscription, the row reads Aucun moyen de paiement (No payment method) and the update control is unavailable until you subscribe.
Related
- Plans: what Free, Pro, and Max include.
- Credits: how credits are consumed.
- Top-ups: buy one-off credits without changing plan.
- Deploy overview: how deployment relates to your balance.