Paddle integration

​

Overview

​

Features

• Automatic tracking - All Paddle payments create transactions
• Subscription support - Recurring payment tracking
• Global tax handling - Works with Paddle’s tax collection
• Both Paddle versions - Supports Paddle Billing and Classic

​

Setup - Paddle Billing

​

Step 1: Get API Credentials

1. Log in to your Paddle Dashboard
2. Go to Developer Tools → Authentication
3. Create an API key with appropriate permissions

​

Step 2: Configure in Partnero

1. Go to Program Settings → Integrations
2. Select Paddle
3. Enter your API key and Vendor ID

​

Step 3: Set Up Webhook

1. Go to Developer Tools → Notifications
2. Create a new notification destination
3. Set URL: https://api.partnero.com/v1/integrations/paddle/{your_program_id}/webhook
4. Select events:
   • transaction.completed
   • transaction.updated
   • subscription.created
   • subscription.updated
   • subscription.canceled

​

Step 4: Configure Webhook Secret

1. Copy the webhook signing secret from Paddle
2. Enter it in Partnero’s integration settings

​

Setup - Paddle Classic

​

Webhook Configuration

• payment_succeeded
• payment_refunded
• subscription_created
• subscription_updated
• subscription_cancelled

​

How It Works

​

Payment Flow

​

Customer Attribution

1. Referral Cookie - From clicking referral link
2. Passthrough Data - Custom data in Paddle checkout
3. Coupon Code - Partner’s coupon code

​

Passing Partner Data

Paddle.Checkout.open({
  product: 123456,
  passthrough: JSON.stringify({
    partnero_partner: 'PARTNER_CODE'
  })
});

Paddle.Checkout.open({
  items: [{ priceId: 'pri_xxx', quantity: 1 }],
  customData: {
    partnero_partner: 'PARTNER_CODE'
  }
});

​

Subscription Handling

​

Recurring Commissions

1. Initial payment creates first transaction
2. Each renewal creates new transaction
3. Partner earns commission on each payment

​

Subscription Lifecycle

​

Refund Handling

1. Paddle sends refund notification
2. Partnero marks transaction as refunded
3. Commission is reversed
4. Partner balance adjusted

​

Testing

​

Sandbox Mode

1. Create sandbox account at sandbox-vendors.paddle.com
2. Configure webhook for sandbox
3. Test with sandbox checkout

​

Test Cards

​

Troubleshooting

​

Next Steps