Subscriptions

The Entitlements → Subscriptions page lists every active Paddle subscription on your org — the base plan plus each add-on line item. Use it to:

• Verify what you’re being billed for.
• Cancel individual add-ons without touching the base plan.
• Resolve overlap notices that surface after a plan upgrade.

What you see

Each row shows:

• The product name (plan or add-on).
• The current price and billing cycle (monthly / annual).
• Next renewal date.
• Status — active, grace_period, past_due, or pending_cancellation.
• A link to the Paddle invoice for the current period.

The plan row also shows the included quotas (slots, regions, runners) — handy for “did this Pro add-on actually take effect?”.

Overlaps

When you upgrade plans, your new plan may already include capacity you previously bought as an add-on. PathWatch detects this and flags it as an overlap:

Your Pro plan now includes 50 Fast uptime slots. You have a previously-purchased +25 Fast uptime add-on adding 25 more.

You can:

Action	Outcome
Keep the add-on	The add-on stays active, you keep the extra 25 slots on top of the plan’s included 50. Higher cost, more headroom.
Cancel the add-on	The add-on stops at the next renewal. The plan’s rolled-in capacity replaces it. Paddle credits the unused balance prorated.

Overlaps don’t auto-resolve — you choose. The overlap notice stays on the page until you act on it.

Cancelling a subscription line

Each row has a Cancel button. Cancellation:

• Takes effect at the end of the current billing period.
• Keeps the add-on (or plan) active until that date.
• After expiry, the entitlement is removed from your bundle.

If cancelling drops your quota below your current usage, monitors (or runners, or status pages) above the new cap are suspended. They don’t get deleted — bring usage back under the cap and they auto-reactivate.

Status meanings

Status	What it means
Active	Subscription is current. Charges proceed normally.
Grace period	Last charge failed. Features keep working for 3-7 days while Paddle retries.
Past due	Grace period expired without payment. Plan-level past-due drops the org to Free; add-on past-due cancels the add-on.
Pending cancellation	You’ve cancelled but the period hasn’t expired yet. Features still work until the date shown.

Reactivating

If a subscription cancelled (yours or Paddle’s), pick it again from Add-ons → Available or Billing → Change plan. The new subscription starts a fresh period; any previously-suspended resources reactivate as soon as the quota covers them.

Paddle as source of truth

PathWatch syncs from Paddle via webhooks. If the WebUI shows a state that doesn’t match what you saw in Paddle’s email receipts, give it a few seconds for the webhook to land, then refresh. If it persists, the Billing → View in Paddle link opens your Paddle customer portal where you can confirm the canonical state.

Programmatic access

• GET /api/v1/billing/subscription — current plan info.
• GET /api/v1/billing/addons/active — active add-on lines.
• GET /api/v1/billing/overlaps — pending overlap notices.
• POST /api/v1/billing/overlaps/:id/cancel — cancel the overlapping add-on.
• POST /api/v1/billing/overlaps/:id/dismiss — keep the add-on.

See the API reference for full details.