Because Paddle is the merchant of record, you never register for tax in each market. Paddle collects and remits, and CashSDK records revenue both net and gross. Reach for Paddle when you sell cross-border on the web and want compliance off your plate.
Paddle
Connect Paddle as your merchant of record so global tax and compliance are handled while every subscription maps to a CashSDK entitlement.
Paddle acts as the merchant of record: it is the legal seller of your product, then handles global sales tax, VAT, invoicing, and chargebacks on your behalf. Connect Paddle to CashSDK and each subscription or one-time order maps to a CashSDK entitlement, so a Paddle customer unlocks the same features as an App Store subscriber and shows up in the same revenue analytics.
How it works#
1
Connect your Paddle account
Add a Paddle Billing API key in your dashboard so CashSDK can read products, prices, and subscription status.
2
Map products to entitlements
Each Paddle Price maps to a CashSDK product and the entitlement it unlocks, so an order resolves to the same access everywhere.
3
Reconcile with verified webhooks
Every Paddle Billing event is signature-verified, retried, and merged into your unified revenue ledger.
Connect Paddle#
1
Create an API key
In Paddle, open Developer Tools → Authentication and create an API key. Copy it now. Paddle shows the full key only once.
2
Add it to CashSDK
In your dashboard, open Settings → Billing → Paddle, paste the key, and choose Sandbox or Production to match the environment. It is stored encrypted at rest.
3
Register the webhook
Copy the notification URL from Settings → Billing → Paddle and add it in Paddle under Developer Tools → Notifications. Subscribe to the subscription and transaction events, then paste Paddle's secret key back into CashSDK so every notification is verified.
Map your catalog#
For each Paddle Price, create a matching product in CashSDK and attach the entitlement it unlocks. Recurring plans and one-off purchases both map cleanly, so subscriptions and lifetime unlocks live in one model.
Test and go live#
1
Test in the sandbox
Connect a Paddle Sandbox key and complete a checkout with a test card. Confirm the entitlement is granted and the order appears under Events in your dashboard.
2
Switch to production
Swap in your production API key and notification secret. Paddle's tax and invoicing settings carry over unchanged.