Introduction to Promotions

This guide covers how to configure and manage location-based pricing promotions in ParityDeals. You’ll learn both the recommended integrated workflow (with payment platforms) and the manual setup for custom needs.

​

What are Promotions?

The ParityDeals Promotions enables you to implement purchasing power parity (PPP) pricing and other location-based discounts, allowing you to offer fair prices worldwide and increase your sales revenue growth.

Location-based discounts are applied to groups of countries based on their economic factors. When a user visits your site from a targeted region, ParityDeals displays a promotional banner with the appropriate discount and coupon code based on their detected location.

​

Getting Started: Two Paths for Promotion Setup

There are two primary workflows for setting up location-based discounts:

​

Setting Up Promotions via Integrated Platforms

This is the recommended workflow if you sell your product via a supported payment platform.

​

Step 1: Connect to Your Payment Platform

1. From the main sidebar, navigate to Promotions.
2. Click the ”+ Create promotion” button.
3. In the “Choose your platform” modal, select the platform you use.
   • Supported integrations include Stripe, Lemon Squeezy, Paddle, Chargebee, Dodo Payments, Polar, Gumroad, and Whop.
4. If connecting for the first time, an authentication modal will appear. Enter the required credentials (e.g., Vendor ID, Auth code/API key) to connect your account.

​

Step 2: Select Your Product

After authenticating, the two-step promotion creation flow begins.

1. Select Product: A list of products fetched from your connected platform account (e.g., Stripe) is displayed.
2. Choose the product for which you want to set up discounts and click “Continue”.

​

Step 3: Set Discounts

You will now see the “Set up discounts” screen, which displays countries grouped by their purchasing power parity factor.

1. Review Discounts: Review the predefined discount percentages for each PPP group and update them as needed. If you do not want to offer a deal for a specific group, leave the discount box empty.

   ParityDeals will automatically create the necessary discount coupons on your integrated platform based on the percentage values you set here.

2. (Optional) Override Group Discounts: To set a different discount for a specific country that overrides its group’s default discount, click the ”+ Create country-specific discount” button.

   • In the modal that appears, select a country from the dropdown, enter the Override discount %, and optionally a specific Coupon code if you want to use a pre-existing one.
   • Click ”+ Add more” to specify overrides for multiple countries.
   • Click “Create” to save your overrides.

​

Step 4: Create the Promotion

1. Once you are satisfied with your discount settings, click the “Create promo” button at the bottom-right of the page.

​

Setting Up Custom Promotions (Manual)

Use this method if you do not use one of our integrated platforms or prefer to manage coupon codes manually.

​

Step 1: Initiate Custom Setup

1. Navigate to Promotions from the sidebar and click ”+ Create promotion”.
2. Select “Custom setup” from the platform choice modal.

​

Step 2: Define Product and Set Discounts

This action takes you to the “Create Promotion” page.

1. Product Setup: In the “Product setup” section, enter your Product name manually.
2. Set Up Coupons: This section displays countries grouped by purchasing power parity.
   • Review Discounts: Review the predefined discount percentages for each group and update them as needed.
   • Enter Coupon Codes: You must first manually create the corresponding discount coupons in your payment provider’s platform. Then, paste each coupon code into the respective “Coupon code” field in ParityDeals.
3. (Optional) Override Group Discounts:
   • Click the ”+ Create country-specific discount” button.
   • In the modal, select a country, set the Override discount %, and paste the specific Coupon code you created for it.
   • Click ”+ Add more” for additional country-specific overrides.
   • Click “Create” to save your overrides.

​

Step 3: Create the Promotion

1. Once all discounts and coupon codes are set, click the “Create promo” button at the bottom-right corner.

​

After Creation: Configuring Your Promotion

After creating a promotion using either method, you will land on its detail page and see a success message. This page contains multiple tabs for powerful post-creation configurations.

<script src="https://cdn.paritydeals.com/banner.js"></script>

<script src="https://cdn.paritydeals.com/banner.js"></script>

​

Managing Promotions

You can edit a promotion at any time after it has been created.

1. Navigate to the Promotions list page.
2. Click the three-dot menu on the promotion you wish to edit and select the “Edit” option from the dropdown. (Alternatively, you can navigate to the promotion’s detail page and find an “Edit” option there).
3. This action takes you back into the promotion editing flow where you update the details.
4. Click “Update promo” (or a similar button) to save your changes. Your updates will be reflected live for your users.

​

Best Practices

• Always test your promotion setup on a staging environment before going live.
• Use clear, descriptive names for each promotion and discount rule.
• Regularly review and update your discount percentages to match market conditions.
• Use country overrides sparingly and only when necessary.
• Never expose secret identifiers in public code.

​

Troubleshooting

Discount not applied?

• Check your product selection and country rules.
• Ensure the user is eligible for a discount based on your rules.
• For integrated platforms, verify your payment provider connection is active.

Banner not showing?

• Ensure your domain is whitelisted in the promotion settings.
• Make sure your API integration uses the correct identifier and parameters.