iFrame

Integrating the referee registration step into your (the brand's) application allows your potential users to skip the register-via-Pass-On step & instead, do so within the context of your app

---

Steps

Follow the steps below carefully to ensure this behaves as expected

1. During the campaign creation phase, you must first provide a value for the Redirect URL property

   • If this value is provided, then referral links will redirect from the Pass On dApp to your above configured Redirect URL, passing along a referral_code query param which you will require in a later step

   • If this is not done, then all referral links related to your campaign will direct the user to the Pass On dApp for registration

2. To handle the redirect to your app, you must extract and pass the `referral_code` query to the iFrame

   • Base URL: https://app.passon.io/portal/register-iframe?referral_code=

   • Example with `referral_code`: https://app.passon.io/portal/register-iframe?referral_code=abc123...

3. Integrate our iFrame directly into your application

   1. Basic example:

      <iframe
        src="https://app.passon.io/portal/register-iframe?referral_code=${referral_code}"
        frameborder="0"
      ></iframe>

   2. Recommendation:

      1. We recommend your app to check (on/before page load) if the referral_code query parameter is present and, if so, to show a modal/pop-up which contains our iFrame.

         • You must pass the referral_code to the modal & append it to the base source URL we provide for this iFrame:

           • Base source URL: https://app.passon.io/portal/register-iframe?referral_code=

         • The user will be shown this modal/pop-up on page load, will have some context about what it means to register and why they should do so

           • When they click the "Register" CTA/button within the iFrame, they'll be prompted with a wallet interaction and, on success, will be shown a relevant message indicating that they can now close the modal/pop-up.

         <!-- Modal containing the iframe -->
         <div class="modal-container">
           <div class="modal-header-text">REGISTER TO EARN CASHBACK</div>
           <div class="modal-close-icon" onclick="closeModal()">X</div>
           <iframe
             src="https://app.passon.io/portal/register-iframe?referral_code=${referral_code}"
             frameborder="0">
           </iframe>
         </div>

---