Stripe sync delays

After Checkout or Billing Portal, Stripe sends webhooks to Polaris. The UI also performs a short sync loop so the user does not see stale plan data.

What users see

When Polaris detects a Stripe return, Billing shows:

Syncing your plan...
We’re confirming your subscription with Stripe. This may take a few seconds.

Upgrade buttons are hidden during sync to avoid showing obsolete CTAs.

Sync strategy

Polaris refetches:

• GET /api/billing/subscription
• GET /api/billing/limits

Polling stops when the expected plan, subscription status or portal update appears. It does not run indefinitely.

If it takes longer

The payment may be received before the webhook finishes processing. Users can select Refresh status or navigate back to Billing later.