Polar

Connect Polar (a developer-native merchant of record with usage-based billing) so orders, subscriptions, and metered usage map to CashSDK entitlements.

Polar is a developer-native merchant of record with first-class usage-based billing and an open-source heart. It is built for teams selling to developers (clean APIs, metered usage, and digital benefits) while still handling tax as the seller of record. Connect it to CashSDK and consumption-based revenue lines up next to seat-based and in-app revenue.

How it works#

1
Connect your organization

Add a Polar access token so CashSDK can read products, subscriptions, and metered usage.

2
Map products to entitlements

Each Polar product maps to a CashSDK product and the entitlement it unlocks; metered usage reconciles as consumption revenue.

3
Reconcile with signed webhooks

Every order, subscription, and benefit-grant event is verified and merged into your unified revenue ledger.

Connect Polar#

1
Create an access token

In Polar, go to Settings → API keys (or your organization's developer settings) and create an organization access token. Copy it.

2
Add it to CashSDK

Open Settings → Billing → Polar and paste the token. It is stored encrypted at rest. Use Polar's sandbox environment while you build.

3
Register the webhook

Copy the endpoint URL from Settings → Billing → Polar and add it in Polar under Settings → Webhooks. Subscribe to the order, subscription, and benefit events, and paste the webhook secret back into CashSDK.

Map your catalog#

For each Polar product, create a matching product in CashSDK and attach the entitlement it unlocks. For usage billing, map the meter to a consumable so metered revenue reconciles alongside subscriptions.

Test and go live#

1
Test in the sandbox

Connect a Polar sandbox token and complete a checkout. Confirm the entitlement is granted and the order appears under Events.

2
Switch to production

Swap in your production token and webhook secret, and move the SDK to csk_pk_….

Next steps#