Subscription billing
Merchant owners manage subscriptions through Closku's dashboard and Polar checkout or customer portal. Storefront requests check subscription entitlement.
Reviewed by Closku documentation team ·
Billing flow
Closku uses Polar for subscription checkout and its customer portal. An account owner starts checkout or opens the portal from the signed-in dashboard. Starter, Growth, and Scale have monthly and yearly options; Enterprise uses agreed custom terms.
The dashboard also supports buying extra usage credits for eligible subscribed merchants. Follow the availability and terms shown in the account rather than treating a credit balance as a widget-request field.
Read current pricing and Billing and plans for amounts and included allowances.
Account authorization
Checkout and portal routes require a signed-in merchant session with the owner role. They are dashboard actions. Do not expose account cookies, payment tokens, or privileged credentials in a storefront integration.
Incoming billing events
Polar sends signed events to Closku's own billing endpoint. Closku verifies the signature before synchronizing subscriptions or processing credits. Credit purchases are applied from confirmed paid-order events with a matching provider customer/merchant association and a valid amount; order creation alone does not credit the balance. Verified refund events reverse the associated order credits. These provider-to-Closku events do not subscribe your application to merchant outbound webhooks.
The widget submission path reads local entitlement. Active, trialing, or applicable grace-period state determines access. If a checkout succeeded but the account has not reflected it, keep the confirmation and contact support rather than repeating payment.
Entitlement failures and plan changes
The widget can return HTTP 402 with merchant_not_entitled_for_try_on when access is unavailable. Check dashboard status and checkout or portal messages. Plan-change timing, renewal dates, taxes, and final amounts follow the actual account terms; this guide does not promise an immediate change or a usage reset on upgrade.
Next steps
Review amounts, periods, and included usage.
Diagnose entitlement failures.
Related pages
Separate rendering and billing states.
Distinguish billing events from merchant callbacks.