Guides
GuidesLog In
Guides

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.