Skip to main content
Paddle is where your billing lives, so connecting it gives GainTrace the revenue picture behind every account: what they pay, whether they will renew, and whether a payment is at risk.
The connector works with Paddle Billing. Accounts still on Paddle Classic cannot use it - the connection check tells you if that is the case.

​
What syncs

GainTrace pulls your Paddle Billing objects and ties them to your Companies:

​
Prerequisites

  • A Paddle Billing account, live or sandbox.
  • Permission to create API keys in Paddle (Developer tools access).

​
Create a Paddle API key

1

Open Paddle's authentication page

In Paddle, go to Developer tools > Authentication and open the API keys tab.
2

Create the key

Click New API key, name it (for example GainTrace), and grant the read permissions the sync needs: customer.read, subscription.read, transaction.read, and payment_method.read.
3

Copy the key

Copy the key when it is shown. Live keys start with pdl_live_, sandbox keys with pdl_sdbx_ - GainTrace detects the environment from the key automatically.
Paddle API keys expire - 90 days by default, one year at most. When a key expires the sync stops and the connection check names the problem; create a new key in Paddle and update the connection under Data > Sources.

​
Connect Paddle

1

Open the catalog

Go to Integrations in the left nav and pick Paddle.
2

Add your API key

Paste the key and confirm. GainTrace verifies it against Paddle before saving, so a failed check saves nothing.
3

Let it sync

Billing data starts flowing in. Manage the connection under Data > Sources.

​
What you can do with it

With Paddle connected, Revenue reflects real MRR and renewal state, and billing trouble becomes a signal in Triage: an overdue transaction, a card that expires before renewal, or a subscription going past due raises a billing-risk signal on the company before it turns into involuntary churn. To also import your product catalog - the plans and prices you sell - use Settings > Pricing & Products > Import from Stripe / Paddle. That import is separate from this connector: the connector syncs live customers and transactions, the import reads your plan catalog.

​
Good to know

  • Transactions sync incrementally; customers, subscriptions, and payment methods refresh fully on each scheduled sync. Changes appear with the next sync run rather than instantly.
  • If the API key lacks payment_method.read, the sync still runs - card details then come only from transaction payment attempts, which cover recently charged cards but not every saved card.
  • This connector is read-only. GainTrace reads your billing data and never changes anything in Paddle.
Last modified on August 13, 2026