Purchases

Klub supports subscriptions and one-time payments through the same flow. You control the checkout UI; the provider handles payment and Klub finalizes access on return and via webhook.

The flow

1. Start checkout with a POST request.
2. The provider processes payment on its hosted page.
3. The provider calls your webhook to sync.
4. Klub grants access by assigning gates.

Endpoints

• POST /klub/payment for one-time purchases.
• POST /klub/subscribe/{plan} for subscriptions.
• GET /klub/payment/{token} and GET /klub/subscribe/{token} for return.
• POST /klub/webhooks/{provider} for sync.

Portal and invoices

• POST /klub/portal redirects to the provider portal (where supported).
• POST /klub/invoice/{subscriptionId} opens invoice previews (where supported).

Related docs

• Subscription Plans
• One-time Payments
• Automatic Member Creation
• Customizing Checkout