# Update your payment details

Source: https://help.mucka.ai/billing/update-payment-details
Category: Billing
Last updated: 2026-08-29

> Change the card, download invoices, or cancel. Web and Team plans use the Stripe portal; app Solo subscriptions are managed through the App Store or Google Play.

How you manage billing depends on where you subscribed. If you're on the **web** or a **Team** plan, Mucka bills through Stripe, so it's a quick hop into the Stripe customer portal (below). If you subscribed to **Solo** inside the iOS or Android app, Apple or Google handles the billing and you manage it through the App Store or Google Play ([jump to that](#in-the-iphone-or-android-app-solo)).

## Open the billing portal

Head to [**Settings → Mucka → Subscription**](/settings/mucka/billing) and tap **Manage subscription**. Mucka opens the Stripe portal in a new tab where you can:

- **Update the card on file** (new card, swap from one card to another)
- **Update your billing address** (Stripe uses this for VAT and invoice address)
- **Update your VAT number** (UK + EU VAT-registered businesses)
- **Download your invoices** (every month Mucka has billed you)
- **Cancel your subscription**

Changes save immediately when you hit Save in Stripe.

## Owner only

Only owners with the **manage billing** permission can open the portal. Admins and engineers see their plan in Settings → Mucka → Subscription but can't change payment details.

If you're the owner and the **Manage subscription** button isn't showing, you might be in a status that doesn't allow it (Trial without a card, Comp). Add a card first by tapping **Add payment method** (appears at trial end or after a failed charge).

## In the iPhone or Android app (Solo)

If you subscribed to Solo inside the app, Apple or Google handles the billing, not Stripe. Manage it right from [**Settings → Mucka → Subscription**](/settings/mucka/billing):

- **Manage subscription** opens your App Store or Google Play subscription settings, where you can change the payment method Apple or Google has on file, switch between monthly and quarterly, or cancel.
- **Restore purchases** re-links your subscription if you reinstall the app or sign in on a new device (using the same Apple ID or Google account).

Receipts for app subscriptions come from Apple or Google, not Mucka.

**Team plans are different.** They're billed per seat through Stripe on the web, so a Team account in the app shows a note pointing you to app.mucka.ai. Sign in from a browser and follow the Stripe steps above.

## Card declined?

If a payment fails (expired card, insufficient funds, bank blocked the charge), Mucka:

1. **Emails you** about the failed charge
2. **Shows "Past due" status** in Settings → Mucka → Subscription
3. **Retries automatically** for 7 days (Stripe handles this)
4. **Pauses the workspace** if not resolved

To recover: open Settings → Mucka → Subscription, tap **Manage subscription**, update the card. Mucka unpauses within minutes.

For **app Solo** subscriptions, Apple or Google handle the retries and any grace period. If their payment fails, update the payment method in your App Store or Google Play settings, and Mucka switches back on once they take the payment.

## Cancelling

**Web or Team (Stripe):** in the Stripe portal, tap **Cancel subscription**. You keep access until the end of your current billing period, then the workspace pauses.

**App Solo (App Store or Google Play):** tap **Manage subscription** on the Billing screen and cancel from your App Store or Google Play settings. Apple and Google require cancellations to go through them, so there's no cancel button inside Mucka itself. You keep access until the end of the period you've paid for.

Either way your data isn't deleted, and you can return any time. If you want your data deleted permanently rather than paused, contact support after cancelling.

## Common gotchas

- **VAT number not accepted by Stripe.** Some EU formats need a country code prefix (e.g. "GB123456789" not "123456789"). Try with and without.
- **Card on file but still "Past due".** Stripe sometimes needs the card re-verified. Open the portal, remove the old card, add it back as a new method.
- **Charged at the wrong VAT rate.** Stripe uses the billing address country for VAT. Update the address if you've moved to a different country.
- **No invoices in the portal.** They appear after your first paid bill. Trial accounts don't have invoices yet.