PriceParity Documentation
Complete guide to implementing Purchasing Power Parity pricing for your SaaS, natively integrated with Paddle Checkout. Launch global pricing in under 5 minutes.
Quick Start (5 Minutes)
Get your API key
Copy your API key from Dashboard → Settings → API Key.
Copy the script tag
Add one script tag to your pricing page (before Paddle.js):
Create a pricing rule
Log in and define which countries get what discounts (e.g., India 60%, Brazil 40%).
Test & launch
Use a VPN to test different regions. PriceParity injects coupons automatically at Paddle checkout.
Minimal script tag:
<script src="https://cdn.priceparity.net/sdk/v2/sdk.js" data-pp-key="YOUR_KEY" data-pp-product="pri_..."></script>Documentation by Role
Core Concepts
Purchasing Power Parity (PPP)
An economic index that measures the relative purchasing power of a currency across countries. A $49 product is expensive in India (PPP 0.38) but fair in the US (PPP 1.0). PriceParity uses World Bank PPP data updated monthly.
Pricing Rule
A configuration that defines which countries get which discount percentages. Example: "Apply 60% off for South Asia region, 40% off for LATAM."
Tier
A group of countries within a pricing rule that share the same discount. One rule can have multiple tiers.
Evaluation
One API call from the SDK when a visitor lands on your pricing page. The SDK detects country and returns the appropriate coupon.
Coupon injection
PriceParity creates or retrieves a Paddle coupon and passes it to Checkout automatically. No code changes needed.
How It Works
Visitor lands on your pricing page
PriceParity SDK loads asynchronously without blocking page performance.
Geo-detection
SDK calls the PriceParity API with your product ID. The API detects the visitor's country from their IP.
Rule matching
PriceParity looks up your active pricing rules and finds the matching tier for that country.
Coupon creation
If a discount applies, PriceParity creates a Paddle coupon (or retrieves a cached one) in milliseconds.
Automatic injection
The SDK passes the coupon code to Paddle Checkout. No extra clicks needed — pricing shows localized instantly.
VPN protection
If VPN blocking is enabled, PriceParity checks if the IP is a known proxy and skips the discount to prevent abuse.
Plan Limits
Essential (Trial)
- 200 evaluations per 30 days
- 1 product
- 1 pricing rule (1 tier)
- Analytics dashboard
Pro ($49/mo)
- Unlimited evaluations
- Up to 10 products
- Unlimited rules and tiers
- Full analytics and API access
- Priority support