Keep Recurly as your billing engine. CashSDK reads the entitlement, not your invoice logic. Tiered, usage, and hybrid pricing models all map to the same entitlement your app checks.
Recurly
Connect Recurly so enterprise-grade subscriptions, dunning, and recovered revenue map to CashSDK entitlements and one unified ledger.
Recurly is enterprise-grade subscription management: flexible billing models, intelligent dunning, and revenue recovery that claws back failed payments before they become churn. Connect it to CashSDK and Recurly MRR folds into one revenue view, so recovered and recurring revenue show up alongside your in-app purchases.
How it works#
1
Connect your Recurly site
Add a Recurly API key so CashSDK can read plans, subscriptions, and their status.
2
Map plans to entitlements
Each Recurly plan maps to a CashSDK product and the entitlement it unlocks.
3
Reconcile with webhooks
Renewals, dunning outcomes, and recovered payments are merged into your unified revenue ledger.
Connect Recurly#
1
Create an API key
In Recurly, go to Integrations → API Credentials and copy your Private API key.
2
Add it to CashSDK
Open Settings → Billing → Recurly and paste the key along with your Recurly subdomain. It is stored encrypted at rest. Use a sandbox site while you build.
3
Register the webhook
Copy the endpoint URL from Settings → Billing → Recurly and add it in Recurly under Integrations → Webhooks. Enable the subscription and invoice events, and (if you use HTTP auth) provide the credentials to CashSDK so it can verify each request.
Map your catalog#
For each Recurly plan, create a matching product in CashSDK and attach the entitlement it unlocks. Every plan resolves to the same entitlement your app already checks.
Test and go live#
1
Test on a sandbox site
Connect a Recurly sandbox key and create a test subscription. Confirm the entitlement is granted and it appears under Events.
2
Switch to production
Swap in your production Recurly API key and webhook settings. The CashSDK key does not change. It already serves both environments.