Technical FAQ & Troubleshooting
Common integration issues and how to resolve them. If your issue isn't covered, email [email protected].
Why isn't the coupon being applied at Paddle checkout?
Most common causes: (1) PriceParity script loads AFTER Paddle.js - move it before. (2) Product ID mismatch - verify price ID in dashboard. (3) No matching pricing rule for visitor country. Enable data-pp-debug="true" to see console logs.
How do I test PPP pricing in different regions?
Use a VPN to connect from different countries (e.g., NordVPN India node). PriceParity detects visitor IP server-side. In localhost development, VPN won't work - deploy to staging URL for testing.
What happens if a visitor uses a VPN?
By default, PriceParity applies the discount to the detected country (VPN origin). If you enable VPN blocking on a tier, PriceParity detects the VPN/proxy and skips the discount. This prevents arbitrage but may frustrate legitimate privacy-conscious users.
How often are coupon codes cached?
PriceParity caches coupons for 24 hours per country-tier combo. This prevents coupon creation spam and API limits. Cache is invalidated if you change tier discount % or countries.
Does PriceParity work with Paddle price IDs (not product IDs)?
Yes. PriceParity works with both Paddle product IDs and price IDs. Use data-pp-product to specify either.
What are the API rate limits?
200 requests/min per API key. 60 requests/min per IP address. Trial plan is limited to 200 evaluations/30 days. Pro plan has unlimited evaluations.
Can I use PriceParity with Paddle's affiliate program?
Yes. PriceParity creates Paddle coupons, which work alongside affiliate links. Affiliates still earn commissions on PPP-discounted sales.
What if my product is on Paddle Subscription or Pay as you go?
PriceParity works with all Paddle payment models: one-time purchases, subscriptions, and pay-as-you-go. Regional discounts apply to all.
How do I handle currency conversion manually?
You don't need to. PriceParity calculates PPP-adjusted prices in the original currency. If your product is $49 USD, Brazil gets R$ equivalent via PPP formula.
Can I exclude certain countries from PPP pricing?
Yes. In the dashboard, only add countries to tiers that you want discounted. Countries not in any tier get full price.
Does PriceParity track consent or privacy policies?
PriceParity uses geolocation from IP address. No personal data is collected. You should disclose IP-based geo-detection in your privacy policy (most do already).
What if PriceParity API is down?
The SDK has built-in failover: if the API doesn't respond within 2 seconds, checkout proceeds without coupon. Your site never breaks due to PriceParity downtime.
Can I A/B test PPP pricing vs flat pricing?
Yes. Run a 50/50 test: enable PriceParity for half your traffic, disable for the other half. Compare conversion rates and revenue.
How do I debug why my API key is invalid?
Verify the key in Dashboard -> Settings -> API Key. Keys start with "pp_". Make sure you're not using the read-only SDK key for API calls (SDK key is for frontend only).
What if I have multiple Paddle products/prices?
Add one script tag per product with different data-pp-product values. Or use a single script and pass product ID dynamically via JavaScript.
For dedicated VPN abuse and pricing arbitrage prevention patterns, see Anti-Fraud and Abuse Prevention.
Related Guides
Still stuck?
Email our support team with your API key and product ID.
Email Support