Setup

This section is for licensed installs. If you are evaluating, start with Concepts and Providers first.

Before you start

  • Choose a provider (Stripe, Paddle, etc.).
  • Decide if you need subscriptions, one-time payments, or both.
  • Decide where plans live (Stripe: provider dashboard; other providers: YAML in content/config).
  • Identify the user blueprint that should store provider data.

Setup path

  1. Install the plugin with Composer.
  2. Register your license key and production domain.
  3. Configure the provider handler and credentials.
  4. Add the provider data field (defaults to the provider key, or set bnomei.klub.providers.{provider}.field to a stable name like klub_provider) to your member blueprint.
  5. Configure webhooks and test a checkout.

Upgrading from v1

If you are coming from v1, the biggest changes are the provider namespace and DTO usage. See the Migration guide for the full checklist.

Next steps

Kirby Klub is not affiliated with the developers of Kirby CMS. We are merely standing on the shoulder of giants.
© 2026 Bruno Meilick All rights reserved.