> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ParityDeals

> Show location-based discount banners on your website and auto-generate matching discount codes in Dodo Payments with ParityDeals.

## Introduction

[ParityDeals](https://www.paritydeals.com/) shows location-based discount banners to eligible visitors on your website and generates the matching discount codes in Dodo Payments. A visitor who sees the banner gets a code to use at checkout. The codes appear in your Dodo Payments dashboard under **Sales → Discounts**.

<Note>
  Dodo Payments has native [Purchasing Power Parity](/features/purchasing-power-parity), which lowers prices by country at checkout with no banner and no script. ParityDeals is for merchants who want a visible discount banner on their own site, or who want to run holiday and time-based deals.
</Note>

## How It Works

ParityDeals detects a visitor's location, shows a customizable discount banner on your website, and gives the visitor a discount code to apply at checkout. ParityDeals creates each code in your Dodo Payments account, and the code works on the products you select.

1. A visitor lands on your website, and ParityDeals detects their location.
2. If the visitor is eligible for a discount, a banner appears with a location-based code.
3. The visitor enters the code at checkout, and Dodo Payments applies the discount.
4. The code appears in your dashboard under **Sales → Discounts**.

<Frame>
  <img src="https://mintcdn.com/dodopayments/9-ym4vw4rAut79bF/images/integrations/paritydeals/banner.png?fit=max&auto=format&n=9-ym4vw4rAut79bF&q=85&s=9889313b66e3b6fe81f433e1f9318782" alt="ParityDeals discount banner example on a merchant website" style={{ maxHeight: '500px', width: 'auto' }} width="1920" height="1440" data-path="images/integrations/paritydeals/banner.png" />
</Frame>

## ParityDeals vs Native PPP

Native Purchasing Power Parity is the recommended way to price by country. Choose ParityDeals when you need a discount banner on your own site, or holiday and time-based campaigns.

| | Native PPP | ParityDeals |
| :- | :- | :- |
| How it works | A percentage per country, applied at checkout | A percentage off, applied through a code |
| Where it is configured | Built into Dodo Payments | ParityDeals dashboard |
| Banner or script on your site | Not required | Required |
| Holiday and time-based deals | No | Yes |
| Best for | Correct prices, with no site changes | Promotional banners and seasonal deals |

<Info>
  You can't embed the ParityDeals banner on a Dodo Payments-hosted checkout or storefront, because they don't support custom scripts. Add the banner to your own website or app.
</Info>

## Prerequisites

Before you set up this integration, you need:

1. A [Dodo Payments account](https://app.dodopayments.com)
2. A [ParityDeals account](https://app.paritydeals.com/)
3. A Dodo Payments API key with write access

## Getting Started

<Steps>
  <Step title="Sign up on ParityDeals">
    Go to [app.paritydeals.com](https://app.paritydeals.com/) and create an account.
  </Step>

  <Step title="Create Deals">
    After you sign in, open the option to create deals. From the dropdown menu, select **Create Deals via Dodo Payments**.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/9-ym4vw4rAut79bF/images/integrations/paritydeals/create-deals.png?fit=max&auto=format&n=9-ym4vw4rAut79bF&q=85&s=a95d6a65e82a30fd9bc781afb5859057" alt="Creating deals via Dodo Payments" style={{ maxHeight: '500px', width: 'auto' }} width="1920" height="1440" data-path="images/integrations/paritydeals/create-deals.png" />
    </Frame>
  </Step>

  <Step title="Generate a Dodo Payments API Key">
    In the Dodo Payments dashboard, go to **Developer → API Keys** and click **Add API Key**. Keep **Enable write access** checked: ParityDeals creates discount codes in your account, and a read-only key can't create resources.

    <Tip>
      Give the key a descriptive name, such as `ParityDeals`, so you can identify it later.
    </Tip>

    <Frame>
      <img src="https://mintcdn.com/dodopayments/9-ym4vw4rAut79bF/images/integrations/paritydeals/api-key.png?fit=max&auto=format&n=9-ym4vw4rAut79bF&q=85&s=bee76bb9b180c07de093401dd5180da2" alt="Creating a new API key in Dodo Payments" style={{ maxHeight: '500px', width: 'auto' }} width="1920" height="1440" data-path="images/integrations/paritydeals/api-key.png" />
    </Frame>
  </Step>

  <Step title="Connect Your API Key to ParityDeals">
    Copy the API key and paste it into ParityDeals to connect your Dodo Payments account. Dodo Payments shows the key only once.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/9-ym4vw4rAut79bF/images/integrations/paritydeals/connect-api-key.png?fit=max&auto=format&n=9-ym4vw4rAut79bF&q=85&s=3e030964fdbe454c1cf6a78fe283f576" alt="Connecting API key to ParityDeals" style={{ maxHeight: '500px', width: 'auto' }} width="1920" height="1440" data-path="images/integrations/paritydeals/connect-api-key.png" />
    </Frame>
  </Step>

  <Step title="Select Products">
    After you connect, ParityDeals fetches your Dodo Payments product catalog. Select the products your deals apply to.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/9-ym4vw4rAut79bF/images/integrations/paritydeals/select-products.png?fit=max&auto=format&n=9-ym4vw4rAut79bF&q=85&s=6fc5db7cb834b5de354addad72213689" alt="Selecting products for ParityDeals" style={{ maxHeight: '500px', width: 'auto' }} width="1920" height="1440" data-path="images/integrations/paritydeals/select-products.png" />
    </Frame>
  </Step>

  <Step title="Configure Deal Settings">
    Enter your website URL. Optionally, select the target pages where the discount banner appears. Then choose a deal type:

    * Location-based deals
    * Holiday deals
    * Time-based flash deals

    <Frame>
      <img src="https://mintcdn.com/dodopayments/9-ym4vw4rAut79bF/images/integrations/paritydeals/deal-settings.png?fit=max&auto=format&n=9-ym4vw4rAut79bF&q=85&s=84cc3941c31981db1a1b6638386ce2a9" alt="Configuring deal settings" style={{ maxHeight: '500px', width: 'auto' }} width="1920" height="1440" data-path="images/integrations/paritydeals/deal-settings.png" />
    </Frame>
  </Step>

  <Step title="Set Country-Based Rules">
    Select the countries that get localized discounts and set the discount percentage for each. ParityDeals suggests default percentages that you can adjust.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/9-ym4vw4rAut79bF/images/integrations/paritydeals/country-rules.png?fit=max&auto=format&n=9-ym4vw4rAut79bF&q=85&s=008156023e4fc7ea43ae4b801c917b98" alt="Setting country-based discount rules" style={{ maxHeight: '500px', width: 'auto' }} width="1920" height="1440" data-path="images/integrations/paritydeals/country-rules.png" />
    </Frame>
  </Step>

  <Step title="Customize the Banner">
    Design your discount banner: edit the text, choose colors and layout, and place the banner at the top or bottom of the page. Eligible visitors see this banner based on your rules.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/9-ym4vw4rAut79bF/images/integrations/paritydeals/customize-banner.png?fit=max&auto=format&n=9-ym4vw4rAut79bF&q=85&s=57950a6f022b2f879f8d85e1f5fe436e" alt="Customizing the discount banner" style={{ maxHeight: '500px', width: 'auto' }} width="1920" height="1440" data-path="images/integrations/paritydeals/customize-banner.png" />
    </Frame>
  </Step>

  <Step title="Add the ParityDeals Script to Your Website">
    After you save the deal, ParityDeals generates a script. Add it to your website code, usually in the `<head>` section. The script detects each visitor's location and shows the matching discount banner.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/9-ym4vw4rAut79bF/images/integrations/paritydeals/script.png?fit=max&auto=format&n=9-ym4vw4rAut79bF&q=85&s=3432e96dbcdcaa9c7d00eaeb0d75f190" alt="ParityDeals integration script" style={{ maxHeight: '500px', width: 'auto' }} width="1920" height="1440" data-path="images/integrations/paritydeals/script.png" />
    </Frame>
  </Step>
</Steps>

## Additional Features

ParityDeals can also run [automatic time-based discounts](https://www.paritydeals.com/features/time-based-discounts/) and [holiday-based promotions](https://www.paritydeals.com/features/holiday-based-discounts/) throughout the year. For details, see the [ParityDeals Documentation](https://www.paritydeals.com/docs/).

## Additional Resources

<CardGroup cols={2}>
  <Card title="ParityDeals Documentation" icon="book-open" href="https://www.paritydeals.com/docs/">
    Full setup walkthrough and feature guide on ParityDeals' docs.
  </Card>

  <Card title="Purchasing Power Parity" icon="money-bill-trend-up" href="/features/purchasing-power-parity">
    Native PPP pricing in Dodo Payments, no banner required.
  </Card>

  <Card title="Discount Codes" icon="percent" href="/features/discount-codes">
    How discount codes work in Dodo Payments.
  </Card>

  <Card title="Evendeals" icon="tags" href="/integrations/evendeals">
    An alternative discount-code tool, with automatic coupon rotation.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.