Billing Troubleshooting

If clicking Upgrade fails:

• Refresh Billing page and retry
• Confirm you are signed into the correct organization
• Verify your network allows redirects to Stripe checkout

Manage Billing requires an existing Stripe customer record.

If unavailable:

• Start a paid plan checkout first
• Complete Stripe flow and return to Billing
• Retry opening portal

SMS add-ons are available only on Pro and Business tiers.

If purchase fails:

• Confirm current tier in Billing
• Retry checkout after page refresh
• Check that the organization has a valid Stripe customer

Stripe webhooks update subscription state and plan limits. If status appears stale:

• Wait a minute and refresh Billing
• Verify Stripe webhook configuration in your deployment
• Confirm STRIPE_WEBHOOK_SECRET is set correctly

Payment failures can set subscription status to past_due.

On self-hosted deployments, verify Stripe settings:

• STRIPE_SECRET_KEY
• STRIPE_WEBHOOK_SECRET
• Tier price IDs (STRIPE_PRICE_*)
• SMS add-on price ID (STRIPE_PRICE_SMS_ADDON)

• Manage Subscription Changes
• SMS Usage and Add-on Packs
• Billing Overview