Guides
GuidesLog In
Guides

Paddle

This page describes how to connect Paddle

Overview

Apphud offers the capability to monitor web-based payments processed through Paddle. This integration allows you to track web subscriptions within Apphud and grant premium access to mobile app users who purchase subscriptions via the web.

Key Features:

  • Seamless Premium Access: Automatically grant premium access in your mobile app to users who subscribe through your website, ensuring a unified experience across platforms.
  • Cross-Platform Analytics: Access unified subscription data through Apphud’s dashboard, enabling easy tracking, monitoring, and analysis of web and app-based subscriptions in one place.

How to add integration?

  1. Navigate to the Apphud Settings and select the Web Payments page
  1. To integrate your Paddle account with Apphud, 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:

That’s It! You’re Done! Your Paddle account is now successfully integrated with Apphud.

📘

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

You can connect one Paddle account to multiple Apphud apps. To do this, please contact our support team for guidance.

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 the IDs 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

Once your Stripe integration is complete, add your Paddle Products to the Apphud Product Hub:

  1. Ensure that your products are created in Paddle's Catalog.
  1. Enter the 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. However, for immediate cancellations, prorated amounts will not be counted.

Billing Issues: If a subscription renews but the invoice remains unpaid, Apphud will mark the subscription as having a billing issue until Paddle confirms the payment.

Renewals: Paddle generates renewal events before actual invoice payments. As a result, Apphud defers renewal events and does not forward them to integrations until payment is confirmed by Paddle. This may take up to an hour after renewal event.

For immediate assistance or to learn more about integrating Stripe with Apphud, please contact our support team.