Paddle
This page describes how to connect Paddle
Overview
Apphud now offers the capability to monitor web-based payments processed through Paddle. This functionality enables tracking of web subscriptions within Apphud, and granting users premium access to mobile apps following their subscription purchases on the web.
Key Features:
- Provide premium access to mobile app users who have purchased subscriptions via the web, seamlessly integrating their experience across platforms.
- Cross-platform analytics through a unified dashboard simplifies subscription data monitoring and analysis.
How to add integration?
- Go to Apphud Settings and open Web payments page:
- To integrate your Paddle account with Apphud, simply click the Add button and fill in the required fields following the on-screen instructions:
The payment provider data can be found in your Paddle account under Developer Tools -> Authentication section:
You're done!
Multiple Paddle accounts
If you need to link more than one Paddle account to Apphud, please reach out to our support team for assistance and additional information.
Link a Single Paddle Account to Multiple Apps
It is possible to connect one Paddle account to several Apphud apps. Please contact our support team for help.
Matching Paddle Customers with Apphud Users
To ensure subscriptions are correctly attributed to users, match the user IDs generated by Paddle upon purchase (e.g., ctm_01jadbpmzwqcafhp2hr3e1356f
) with those in your app.
Save the Paddle-generated user ID on your backend and pass it to the Apphud SDK during initialization:
Apphud.start(apiKey: "YOUR_API_KEY", userID: "cus_SomePaddleId")
Create Products
With Paddle integration completed, you can add Paddle products to the Apphud Product Hub.
- First, ensure that your products are created in Paddle's Catalog.
- Then, enter Product ID - Price ID pairs for each product into the Apphud Product Hub:
Limitations
Refunds and Upgrades/Downgrades
Apphud does not support proration. Refunds are only processed as full amounts; partial refunds are considered full refunds.
Usage Types
Metered usage and tiered pricing are not supported. Apphud only supports per-unit pricing and recurring packages.
Cancellations
Both immediate cancellations and end-of-period cancellations are supported. For immediate cancellations, note that prorated amounts will not be counted.
Billing Issues
If a subscription renews but the invoice remains unpaid, Apphud marks the subscription as having a billing issue until payment is confirmed by Paddle.
Renewals
As known, Paddle creates renewal events before the actual invoice payment. This is why Apphud renewal Events will be deferred and not forwarded to integrations until payment is confirmed by Paddle. This may take up to an hour after the renewal event.
For immediate assistance or to learn more about integrating Paddle with Apphud, please contact our support team.
Updated 24 days ago