Paddle Billing Integration

Connect Paddle Billing and refVenue tracks purchases, subscription renewals, refunds, and chargebacks automatically — commissions are created and reversed without any manual work.

Using Paddle Classic? Contact support — this integration targets Paddle Billing (the current Paddle platform).

1. Create a notification destination in Paddle

1. In Paddle, go to Developer Tools → Notifications and create a destination.
2. Set the URL to the webhook URL shown on your refVenue Integration page (it includes your program ID): https://your-refvenue-domain/api/paddle/webhook?program_id=YOUR_PROGRAM_ID
3. Subscribe to these events:
   • transaction.completed
   • adjustment.created
   • adjustment.updated
4. Copy the destination's secret key.

2. Save your credentials in refVenue

On the Integration page, open the Paddle Billing card and paste:

• Secret key (required) — verifies webhook signatures.
• API key (recommended) — create one under Developer Tools → Authentication. It lets refVenue look up the customer's email and discount codes, enabling email and coupon attribution as fallbacks.

3. Pass the referral ID at checkout (recommended)

The refVenue embed script exposes the visitor's referral ID. Pass it into Paddle checkout as custom data and attribution is deterministic:

Paddle.Checkout.open({
  items: [{ priceId: "pri_...", quantity: 1 }],
  customData: {
    refvenue_referral_id: window.refvenue.getReferralId(),
  },
});

For API-created transactions, set the same key in the transaction's custom_data.

Without the referral ID, refVenue falls back to matching the customer's email against tracked signups (requires the API key), then to discount codes matched against affiliate coupon codes.

What gets tracked

Duplicate webhook deliveries are handled automatically — a transaction can never create two commissions.