Let users manage their billing

Give users a “Manage billing” entry point to the Stripe billing portal, where they can update their payment method, view invoices, or cancel. Bridge exposes the portal as a REST endpoint: GET /account/subscription/portal returns a one-time portalUrl to redirect to.

The subscription page <BridgeBillingRoutes /> serves already has this button. To put it anywhere else, render <BillingPortalButton />: it shows only to someone who can use it (the workspace owner, on an app with payments on, whose workspace has a plan) and fetches the portal URL at click time.

<script lang="ts">
  import { BillingPortalButton } from '@nebulr-group/bridge-svelte';
</script>

<BillingPortalButton label="Manage billing" />

To build your own, the SDK wraps the endpoint: getBridgeAuth().getBillingPortalUrl() returns the one-time URL. It builds the request from the apiBaseUrl you configured and attaches the signed-in user’s token and app ID for you, so the same code works on stage and local dev. Call it at click time — the portal session is short-lived, so don’t cache the result.

<script lang="ts">
  import { getBridgeAuth } from '@nebulr-group/bridge-svelte';

  async function openPortal() {
    window.location.href = await getBridgeAuth().getBillingPortalUrl();
  }
</script>

<button onclick={openPortal}>Manage billing</button>

Prefer this over a hand-rolled fetch: hardcoding https://api.thebridge.dev sends a stage or local app to the production API, where its app ID doesn’t exist.

Only the workspace owner may open the portal. getBridgeAuth().canManageBilling() returns whether the signed-in user qualifies — use it to hide or disable the button rather than letting the call fail.

See Subscriptions & Entitlements → Open the billing portal for the endpoint reference.

Recovering from a billing problem? You don’t need this button for that. When a workspace (called a tenant in the API) is past due, in dunning, or billing-locked, <BridgeBillingNotice /> already renders a recovery CTA (it sends the user to your subscription page, /subscription by default). Use this “Manage billing” button for the healthy, everyday case. See Warn about billing problems.