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

# Loop

> Post-purchase claim management made easy with Loop Returns and Order Protection shipping protection.

This guide covers how to integrate Loop within the Order Protection portal. Everything from seeing returns data, toggling seamlessly between Loop and Order Protection for returns and shipping claim information, and setting up your claims portal for a post-purchase one-stop claim filing hub.

<Steps>
  <Step title="Setting up the API integration in Loop">
    Within your Loop admin account, navigate to `Tools & Integrations > Developer Tools` tab. Click `Generate API Key`.

    <img src="https://mintcdn.com/orderprotectioncom/hWJXW3CDmk7aH415/public/assets/img/loop/loop-api-key.png?fit=max&auto=format&n=hWJXW3CDmk7aH415&q=85&s=3ac241f968079cb7539f564456ee70c1" alt="" width="1440" height="897" data-path="public/assets/img/loop/loop-api-key.png" />

    Within the scopes menu, select the following:

    <ul>
      <li>Order</li>
      <li>Developer Tools</li>
      <li>Return</li>
    </ul>

    <img src="https://mintcdn.com/orderprotectioncom/hWJXW3CDmk7aH415/public/assets/img/loop/loop-api-scope.png?fit=max&auto=format&n=hWJXW3CDmk7aH415&q=85&s=27968cda51f709dae9da3fcae4fba413" alt="" width="1440" height="898" data-path="public/assets/img/loop/loop-api-scope.png" />

    Click `Generate` and copy the API key.
  </Step>

  <Step title="Enabling the Loop Integration in Order Protection">
    From settings, go to the `General` tab. Scroll to the bottom and under the `Returns` block, select edit and select **Loop Returns** as the provider.

    <img src="https://mintcdn.com/orderprotectioncom/GDuchlp6KbhScehe/public/assets/img/loop/loop-select-general-settings.png?fit=max&auto=format&n=GDuchlp6KbhScehe&q=85&s=a5cccdcaa639eabc9609285217fec003" alt="" width="1438" height="904" data-path="public/assets/img/loop/loop-select-general-settings.png" />

    From there, head over to the `Integrations` tab. Within the `Available` sub-tab, edit the Loop block. Here, input the API key and hit `Save`.

    <img src="https://mintcdn.com/orderprotectioncom/hWJXW3CDmk7aH415/public/assets/img/loop/loop-available-integration.png?fit=max&auto=format&n=hWJXW3CDmk7aH415&q=85&s=d7d4c6d88af5a83befc13eb914a46b1b" alt="" width="1443" height="903" data-path="public/assets/img/loop/loop-available-integration.png" />

    Once saved, the block will also appear in the `Active` sub-tab.

    <img src="https://mintcdn.com/orderprotectioncom/hWJXW3CDmk7aH415/public/assets/img/loop/loop-active-integration.png?fit=max&auto=format&n=hWJXW3CDmk7aH415&q=85&s=be9e781fac6dceb84fdcf9181eec1972" alt="" width="1440" height="902" data-path="public/assets/img/loop/loop-active-integration.png" />
  </Step>

  <Step title="Changes to the customer claim portal">
    First we start with the customer claim filing portal. This can either be the Order Protection generic portal or your own customized portal. To set up your customized portal, follow [these instructions](/education-basecamp/customizations/branding-your-portal). Now that the integration is set up, you will see a new block in the customer claim filing portal to file a return.

    <img src="https://mintcdn.com/orderprotectioncom/hWJXW3CDmk7aH415/public/assets/img/loop/loop-concierge.png?fit=max&auto=format&n=hWJXW3CDmk7aH415&q=85&s=93b54e23670b5c362e13a1881e1d39bb" alt="" width="1441" height="905" data-path="public/assets/img/loop/loop-concierge.png" />

    Once the `Start a new return` button is pressed, the customer will be re-directed to your returns portal with the proper URL parameters for order number and customer email.

    <img src="https://mintcdn.com/orderprotectioncom/GDuchlp6KbhScehe/public/assets/img/loop/loop-returns-page.png?fit=max&auto=format&n=GDuchlp6KbhScehe&q=85&s=f52d8d085b50fa0cbb3372e418782e36" alt="" width="1441" height="901" data-path="public/assets/img/loop/loop-returns-page.png" />
  </Step>

  <Step title="Changes within the OP app">
    Now that the integration is set up, you also have additional functionality within the OP app as well.

    First, you now have a view of all returns within the `Returns` left navigation tab. By clicking on any of the rows, it will take you to the order detail page to show you return details (file date, return label, tracking, etc.)

    <img src="https://mintcdn.com/orderprotectioncom/GDuchlp6KbhScehe/public/assets/img/returns/returns-page-valet.png?fit=max&auto=format&n=GDuchlp6KbhScehe&q=85&s=8e16ee1020357d69c9d3cfc259b72902" alt="" width="1440" height="905" data-path="public/assets/img/returns/returns-page-valet.png" />

    Once on the order detail page, you will see a return block pinned to the top. From here, you can see which order items are on the return, return metadata, and a button that says `View in Loop`. By clicking that button, you will do an authorized jump to your return instance for the given order. From here, you can view all return data and make any necessary manual return actions.

    <img src="https://mintcdn.com/orderprotectioncom/GDuchlp6KbhScehe/public/assets/img/loop/loop-view-claim-button.png?fit=max&auto=format&n=GDuchlp6KbhScehe&q=85&s=ac5b3ae71f1176ae32268b38caa75f17" alt="" width="1441" height="904" data-path="public/assets/img/loop/loop-view-claim-button.png" />

    Additionally, another benefit of the Loop Returns / Order Protection integration is that we will block returns and/or shipping claims for order items that have a post-purchase claim filed (e.g. will block a shipping claim if a return is open on the given order item that a customer also wants to file a shipping claim for).
  </Step>

  <Step title="Removing OP and other digital items as eligible return items">
    To remove Order Protection as an eligible return item within the item selection menu of an order return, tag the product (and any other digital item) as "Final Sale" both within Loop and Shopify.

    <ul>
      <li>
        In your Loop Admin, go to Returns management > Policy settings > General >
        Product Tags.
      </li>

      <li>Set the `final-sale` tag on the Order Protection product. </li>

      <li>
        In Shopify, apply this exact tag to all your digital/virtual products.
      </li>
    </ul>

    Once tagged (at the time of purchase), Loop automatically blocks these items from appearing as returnable in the customer portal.
  </Step>
</Steps>

## Questions or suggestions?

If you are having difficulty enabling your integration or have suggestions on how the integration could be better, reach out to [product@orderprotection.com](mailto:product@orderprotection.com)
