Providers

Klub works with multiple payment providers through a shared interface. You can switch providers without changing your templates, but each provider has its own checkout and billing rules.

Use this page to compare provider capabilities before setup.

Choose a provider

All providers share the same checkout/return/webhook routes. Features like portal links and invoice previews vary by provider, so use the matrix below and the provider pages for setup details. Stripe fetches plans/products from the Stripe API; other providers use local plan definitions.

Provider setup basics

• Set bnomei.klub.provider.handler.
• Add the provider data field (bnomei.klub.providers.{provider}.field) to the member blueprint.
• Configure credentials and webhook secret.

Webhook verification

Webhook verification failures on /klub/webhooks/{provider} return HTTP 403. Some providers support optional verification modes:

• Chargebee verifies webhook auth only when webhook_auth/webhook_secret is configured.
• Mollie verifies X-Mollie-Signature only when webhook_secret is configured for JSON webhooks.

Provider docs

• Chargebee
• Lemon Squeezy
• Mollie
• Paddle
• PayPal
• Polar
• Stripe