Paddle

Paddle has the best native support for PPP-like pricing through its unitPriceOverrides feature on Price objects. GoPayLocal can use both native price overrides and standard percentage/flat discounts.

Setup

1. Get your Paddle API key

   Go to Paddle Dashboard > Developer Tools > Authentication. Create an API key.

   For testing, use the Paddle Sandbox environment.

2. Connect in GoPayLocal

   Go to your GoPayLocal dashboard > Settings > Integrations > Paddle and click Connect. Enter your API key in the dialog. Select Test environment for sandbox testing.

   Click Test after connecting to verify your credentials.

3. Create a campaign

   Select Paddle as the payment provider in your campaign settings.

Price Overrides (Native PPP)

Paddle’s unitPriceOverrides lets you set different prices per country/region directly on Price objects. This is the most native PPP implementation:

{
  "unit_price": {
    "amount": "9900",
    "currency_code": "USD"
  },
  "unit_price_overrides": [
    {
      "country_codes": ["IN"],
      "unit_price": {
        "amount": "49900",
        "currency_code": "INR"
      }
    },
    {
      "country_codes": ["BR"],
      "unit_price": {
        "amount": "4990",
        "currency_code": "BRL"
      }
    }
  ]
}

GoPayLocal can create and manage these overrides automatically, giving you true per-country pricing in local currencies.

Percentage Discounts

Alternatively, GoPayLocal creates standard Paddle discounts:

{
  "type": "percentage",
  "amount": "30",
  "code": "PPP-INDIA-30",
  "description": "PPP discount for India (30% off)"
}

Auto-Apply

Paddle supports auto-applying discounts through the checkout overlay:

Paddle.Checkout.open({
  items: [{ priceId: 'pri_xxx', quantity: 1 }],
  discountCode: 'PPP-INDIA-30',
});

Or via the inline checkout:

<div
  class="paddle-checkout"
  data-items='[{"priceId": "pri_xxx", "quantity": 1}]'
  data-discount-code="PPP-INDIA-30"
></div>

Sandbox Environment

Paddle provides a full sandbox for testing:

• Sandbox URL: https://sandbox-vendors.paddle.com
• Separate API keys for sandbox
• Test cards available
• Webhooks fire in sandbox

Set the environment to sandbox in your GoPayLocal integration settings.

Webhooks

Webhook handling for Paddle is planned. Currently, discount code creation and checkout integration work fully. Redemption tracking via webhooks is on the roadmap.

Tip

If you’re starting fresh, Paddle’s unitPriceOverrides is the cleanest PPP implementation — true per-country pricing in local currencies without coupon codes. GoPayLocal can manage these overrides for you.

Limitations

• Paddle is a Merchant of Record, so you cannot combine PPP discounts with other promotional discounts
• Price overrides are limited to one per country per price
• Sandbox and production use separate Paddle accounts