Paddle billing

Free and Pro billing, localized prices, secure webhooks, and the customer portal.

Server-side essentials
Security and runtime requirements for every integration.

Official SDKs are server-side only.

Never expose API keys in browser or client code.

Store API keys in environment variables.

The default fallback is false.

SDKs fail safely if SwitchPilot is unreachable.

Default cache TTL: 60 seconds.

Default stale-if-error window: 5 minutes.

Plans and localized pricing

Free costs 0 € and includes one project, five account-wide flags, Development and Production, and seven days of change history. Pro includes up to five projects, one hundred flags, complete history and audit, and priority support. The existing monthly Paddle price remains 19 EUR before tax, with automatic Paddle localization where configured.

Sandbox configuration

.env.local
NEXT_PUBLIC_PADDLE_ENV=sandbox
NEXT_PUBLIC_PADDLE_CLIENT_TOKEN=
NEXT_PUBLIC_PADDLE_PRO_PRICE_ID=
PADDLE_API_KEY=
PADDLE_WEBHOOK_SECRET=
PADDLE_PRO_PRODUCT_ID=

The live “SwitchPilot Pro” product, price, checkout, webhooks, customer portal, taxes, and cancellation flow are unchanged. Subscription events remain the authority for Pro access.

Secure synchronization

Only signed Paddle webhooks change plan access. The handler verifies the raw request body, stores each event ID once, ignores older subscription events, and resolves ownership by subscription, customer, then validated internal user ID.

Customer Portal and downgrade

Portal URLs are temporary and created on every click. A downgrade never deletes or disables projects, flags, Production environments, keys, or metadata. Existing resources remain active while creation follows the Free limits.

Live checklist

  • Approve the Paddle account and domain.
  • Create the Live product, 19 EUR monthly price, and 19 USD US override.
  • Enable automatic currency conversion and copy Live-only IDs and credentials to Vercel.
  • Create the Live webhook and secret, run one controlled real payment, and verify no Sandbox secret remains in production.