Skip to main content
The photon billing commands let you view available plans, check your current subscription, start a checkout, and manage billing through the Stripe Customer Portal. All billing commands require an active project. Set $PHOTON_PROJECT_ID or pass --project <id>.

​
List available plans

photon billing plans
Shows all plans and their Stripe price IDs. Use the price ID with checkout to subscribe.

​
View current subscription

photon billing show
photon billing show --json
Displays the active subscription for the current project, including plan details and status.

​
Start a checkout

# Interactive picker — recommended for first-time use
photon billing checkout

# Skip the picker with a positional tier
photon billing checkout pro
photon billing checkout business --qty 5

# Use a specific Stripe price (escape hatch)
photon billing checkout --plan price_xxx
When you run this command, the CLI creates a Stripe Checkout session and opens it in your browser. If you don’t pass any arguments, you get an interactive picker listing the available plans. Pass a [tier] positional or --plan <price-id> to skip the picker. Available tiers: pro, business, enterprise.
FlagDescription
[tier]Positional tier (pro / business / enterprise). Skips the picker.
--plan <price-id>Stripe price ID. Escape hatch when you need a specific price.
--qty <number>Quantity for the line item
--no-browserPrint the checkout URL instead of opening it
--jsonOutput {action, url, tier?} as JSON and skip opening the browser
For project-scoped subscription management (which smart-routes between Checkout and the Stripe Portal), use photon projects upgrade instead.

​
Manage subscription (Stripe Portal)

photon billing manage
Opens the Stripe Customer Portal where you can update payment methods, change plans, view invoices, or cancel. Pass --no-browser to get the portal URL printed to the terminal. Aliases: billing portal.

​
Common flags

FlagEnv varDescription
-p, --project <id>PHOTON_PROJECT_IDTarget project
--api-host <url>PHOTON_API_HOSTOverride the backend URL
-t, --token <token>PHOTON_TOKENUse this token instead of stored credentials
--json—Output as JSON
--no-browser—Print URL instead of opening the browser