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

# Testing the Referee Tag

> How to test the Mention Me referee tag on your checkout page in both Demo and Live environments.

The referee tag lets new customers confirm who referred them at checkout and unlock their reward. This guide covers testing the tag in both Demo and Live environments.

## Understanding Referee Eligibility

The referee eligibility tag communicates reward approval status to Mention Me. When you pass a referee-eligible tag, you're telling the system one of the following:

1. **Referee reward is pending approval** -- you're confirming the referee has met your criteria and their reward can be fulfilled. Most common in the "after purchase" case (e.g. waiting to confirm the referee has completed an action before issuing a reward).

2. **Referee is approved but referrer reward is pending** -- you're saying the referee introduced by the referrer has met eligibility criteria, and the referrer can now be rewarded. Most common in the "before purchase" case where the referee has already received their reward.

3. **Both referee and referrer require approval** -- only the referee approval is processed automatically. The referrer approval is handled separately (e.g. the referee gets a subscription credit automatically while the referrer gets a manually-approved reward).

<Tabs>
  <Tab title="Demo">
    <img src="https://mintcdn.com/mentionme/DW6A4iNCa7LrbN3W/images/knowledge/onboarding/testing/31627907868829.gif?s=c98f98f852baa599c5e15f5dba6b5968" alt="Testing the referee tag in DEMO environment" width="800" height="357" data-path="images/knowledge/onboarding/testing/31627907868829.gif" />

    ## Website Test

    <Steps>
      <Step title="Navigate to checkout">
        Go to your site, add an item to your basket, and proceed to checkout (don't submit payment).
      </Step>

      <Step title="Check for the referee link">
        Check for the visible referee link: **"Been referred by a friend?"** near the email, promo, or form field.
      </Step>

      <Step title="Complete the referral overlay">
        Click the link, complete the overlay (enter the referrer you created and your test referee email), and submit. Note the code or reward that displays.
      </Step>

      <Step title="Verify network requests">
        Open DevTools, go to the Network tab, reload the page, and filter for your **partnerCode**. Confirm a request to **tag-demo.mention-me.com** with:

        * **environment:** demo
        * **partnerCode** and **localeCode** are correct
        * **situation:** checkout
      </Step>
    </Steps>

    <img src="https://mintcdn.com/mentionme/DW6A4iNCa7LrbN3W/images/knowledge/onboarding/testing/31627907870365.png?fit=max&auto=format&n=DW6A4iNCa7LrbN3W&q=85&s=85443c202dd9d093ccfc65078adb1104" alt="Network tab showing DEMO referee tag request details" width="1120" height="860" data-path="images/knowledge/onboarding/testing/31627907870365.png" />

    ## Platform Verification

    <Steps>
      <Step title="Open the Customers page">
        Go to the [**Customers**](https://demo.mention-me.com/merchant/~/customers/) page in the Mention Me platform.
      </Step>

      <Step title="Search for your referee">
        Search for your referee.
      </Step>

      <Step title="Confirm the profile">
        Open the profile and confirm:

        * The referee is created and status shows "awaiting purchase"
        * Details match your campaign and locale
      </Step>
    </Steps>

    <img src="https://mintcdn.com/mentionme/DW6A4iNCa7LrbN3W/images/knowledge/onboarding/testing/31627907872285.gif?s=74a4a193b274d941af748ca86f14158e" alt="Verifying referee profile status in platform" width="800" height="357" data-path="images/knowledge/onboarding/testing/31627907872285.gif" />

    ## Troubleshooting

    * **Link not displaying** -- confirm JavaScript and wrapper are present, and the referee tag is enabled for this page.
    * **Overlay doesn't appear** -- check for the correct page element (`<div id="mmWrapper">`) and install errors in the console.
    * **No profile created** -- use a completely new test email and check that you're searching the demo environment.
    * **Requests go to tag.mention-me.com (not DEMO)** -- update your script for DEMO testing.

    ## Need Help?

    Contact the team via the [help form](https://help.mention-me.com/hc/en-gb/requests/new?ticket_form_id=1900000712373) with testing steps and screenshots.
  </Tab>

  <Tab title="Live">
    <img src="https://mintcdn.com/mentionme/DW6A4iNCa7LrbN3W/images/knowledge/onboarding/testing/31620817463709.gif?s=fb7934f45317d413cde60f8ff5b9a56b" alt="Testing the referee tag in LIVE environment" width="800" height="356" data-path="images/knowledge/onboarding/testing/31620817463709.gif" />

    ## Website Test

    <Steps>
      <Step title="Navigate to checkout">
        Go to your live website, add an item to your basket, and proceed to checkout (do not make a real payment unless you intend to place an order).
      </Step>

      <Step title="Check for the referee link">
        Check for the visible referee link: **"Been referred by a friend?"** near the email, promo, or form field.
      </Step>

      <Step title="Complete the referral overlay">
        Click the link, complete the overlay (enter your real referrer's details and a new referee email), and submit. Note the code or reward that displays.
      </Step>

      <Step title="Verify network requests">
        Open DevTools, go to the Network tab, reload the page, and filter for your **partnerCode**. Confirm a request to **tag.mention-me.com** with:

        * **environment:** production
        * **partnerCode** and **localeCode** are correct
        * **situation:** checkout
      </Step>
    </Steps>

    <img src="https://mintcdn.com/mentionme/DW6A4iNCa7LrbN3W/images/knowledge/onboarding/testing/31620921401885.png?fit=max&auto=format&n=DW6A4iNCa7LrbN3W&q=85&s=06a52e49e7ce654e5b6bc75b79e4fcb4" alt="Network tab showing LIVE referee tag request details" width="2020" height="965" data-path="images/knowledge/onboarding/testing/31620921401885.png" />

    ## Troubleshooting

    * **Link not displaying** -- confirm the JavaScript and wrapper are present, and the referee tag is enabled for this page.
    * **Overlay doesn't appear** -- check for the correct page element (`<div id="mmWrapper">`) and check for JavaScript errors in the console.
    * **No profile created** -- use a completely new email and check that you're searching the production environment.
    * **Requests go to tag-demo.mention-me.com** -- update to the live/prod tag (**tag.mention-me.com**).

    ## Need Help?

    Contact the team via the [help form](https://help.mention-me.com/hc/en-gb/requests/new?ticket_form_id=1900000712373) with test steps and screenshots.
  </Tab>
</Tabs>
