Skip to main content

Connect Paddle

Paddle is a billing provider for coupons and for MRR proof points, alongside Stripe, Polar, Lemon Squeezy, Dodo Payments, and RevenueCat. Each product has one coupon billing connection. Connecting Paddle for coupons replaces any previous coupon provider on that listing. MRR is a separate proof connection. Dealpuffin never asks for a key that can charge cards for you, and Paddle is not a way to sign in.

Coupons​

  1. In Paddle, open Developer tools, then Authentication.
  2. Create an API key named Dealpuffin.
  3. Turn on discount.read. Leave write permissions off.
  4. Copy the key. Live keys start with pdl_live_apikey_. Sandbox keys start with pdl_sdbx_apikey_.

Open the product from Submit a product, choose Paddle, and paste the key in Coupons. Dealpuffin checks that the key can read discounts, encrypts it, and runs the first import. You only see a hint of the key after that.

Only discounts that are active, enabled for checkout, and have a code are imported. Percentage and flat discounts map into Dealpuffin. Per-seat (flat_per_seat) discounts are skipped.

Optional Paddle product (pro_…) or price (pri_…) ids live on that connection. A discount limited to those ids can be published only when the ids overlap.

Use a live key for coupons you want real early adopters to redeem. A sandbox key only talks to Paddle sandbox.

MRR proof​

  1. Create an API key (or reuse one) with subscription.read.
  2. On the product page, open Proof points, choose Paddle, and paste the key.

The reading is the sum of active subscription items with a recurring billing cycle, normalized to one month. See Proof points.

Coupon and proof connections are stored separately, even when you paste the same key twice.

What is stored​

The plaintext key is not stored. A connection keeps an encrypted ciphertext, a nonce, a short hint, and the last sync time. Sync does not publish coupons. See Sync and publish.