Billing and Entitlements
Source of truth
Section titled “Source of truth”Polar is the billing source of truth.
Fast path used by the product
Section titled “Fast path used by the product”Supabase stores the entitlement cache used during normal requests.
Important rule
Section titled “Important rule”The UI never grants Pro directly. Access changes only after the platform verifies billing state and updates the internal entitlement model.
Lifecycle
Section titled “Lifecycle”- UI requests checkout from ClawOS
- API creates Polar checkout
- Polar sends webhook events
- ClawOS verifies the webhook
- ClawOS updates entitlement state
- UI and worker behavior reflect the updated cache
Why this design is better
Section titled “Why this design is better”Routine product requests stay fast and stable because they do not depend on live billing calls on every interaction.