Skip to main content

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.

Subscriptions & Stripe

Understand the billing relationship behind the customer portal.