> ## Documentation Index
> Fetch the complete documentation index at: https://aidocs.ethanbragdon.icu/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Portal & Invoices

> Use the Stripe-backed customer portal for supported payment methods, invoices, subscription actions, and billing history.

# Customer portal & invoices

Starfire can use Stripe-hosted customer portal flows for supported billing self-service while keeping raw payment credentials outside the Starfire application.

## Open the portal

From the Starfire billing surface, open the customer portal action for the active personal or organization billing context.

Starfire must resolve the correct linked Stripe Customer before creating the portal session.

## Supported actions

The exact portal configuration can vary, but supported self-service actions can include:

* viewing invoices
* updating payment methods
* reviewing subscription state
* cancelling a subscription
* changing a plan when enabled
* reviewing billing history

## Personal vs organization portal

Confirm the active billing context before opening the portal. A personal Stripe customer and an organization Stripe customer are separate relationships.

## Invoices

Invoices are payment-provider records. Starfire product entitlements are derived from reconciled subscription state, not from the existence of an invoice alone.

## Portal does not open

Possible causes include:

* no linked Stripe customer
* wrong personal/organization context
* billing account not fully provisioned
* Stripe/customer portal configuration problem
* temporary backend error

Do not create a new subscription solely because the portal failed to open.

## Payment data

Use the provider-hosted portal for card/payment-method management. Starfire support and documentation should not collect full card numbers or security codes.

<Card title="Subscriptions & Stripe" icon="money-check-dollar" href="/billing/subscriptions-stripe">Understand the billing relationship behind the customer portal.</Card>
