Skip to main content
The Order Protection widget integrates with Ordergroove and your Shopify store, enhancing the subscription order experience for users with all relevant information in one place.The widget addition to the cart simplifies the claim-filing process for users reducing friction and eliminating the need for manual navigation to the Order Protection website.

Installation

1

Generate an API Token

Access the Ordergroove admin page: Ordergroove Admin
  • Go to Developers menu and click on API Keys
  • Click on Create button
  • Enter a Name and Email
    • Name: Order Protection
    • Email: onboarding@orderprotection.com
    • Permissions: Read and Write (required — Read Only will cause the Send Now flow to fail with a 401 when Order Protection tries to sync its line item onto the order)
    • Allow bulk queries?: Yes
  • Click on Save button
  • Copy the API Key for Step 3
API Token

Creating an API Token

2

Create a Webhook

Since Ordergroove does not have a way to automate the creation of webhooks, we will need to create them manually.
  • Go to Developers menu and click on Webhooks
  • Click on Create button
  • Enter a Name and Email
    • Webhook Name: Order Protection
    • Webhook URL: https://subscriptions.production.orderprotection.com/api/v1/webhooks/ordergroove/[PLATFORM_DOMAIN]/webhook
      • Replace [PLATFORM_DOMAIN] with your platform domain. e.g. for Shopify it would be example.myshopify.com
  • For events, tick only subscription.create
    • Note: there is a similar event called subscriber.create, please note to tick the correct one Webhook
  • No actions on Advance Settings
  • Click on Save button
  • Copy the Verification Key for Step 3
Webhook

Creating a Webhook

3

Integrate Ordergroove within the Order Protection Platform

Within the Order Protection app, do the following:
  • Navigate to Integrations in the left navigation.
  • Find the Ordergroove block under the Available tab.
  • Take the API token you created in Step 1 and the Webhook Verification Key you created in Step 2 and add it to the corresponding fields and save.
  • Once saved, click on the Active tab and the API token and Webhook Verification Key fields within the Ordergroove block will have a hidden value. This means that your token and webhook successfully uploaded. ordergroove api token in op app
4

Install Scripts in Ordergroove's Subscription Manager

  • Go to Subscriptions menu and click on Subscription Manager
  • Click on Advanced toggle button
  • On the side menu, click on View
  • Click on ADD NEW FILE, and name it orderprotection.liquid with content:
    orderprotection.liquid
  • Go to /views/order/main.liquid, enter new line after {% include 'order-summary/main' %} and add:
    order/main.liquid
    Like below: Paste code
  • Go to /views/order-level-actions/send-order-now.liquid and change the button:
    order-level-actions/send-order-now.liquid
    to:
    order-level-actions/send-order-now.liquid
  • Lastly, go to /scripts/script.js and add the following code to the bottom of the file:
    script.js
Once set up, Order Protection will be added to all cart instances within Shopify subscription orders using Ordergroove. Customers can choose to opt-in or opt out of Order Protection for their subscription orders.
Customers will be able to file/edit claims per your normal store settings once an order confirmation email has been sent.
Did you know? You can customize the Order Protection widget styling specifically for your subscription portal. When creating a new widget, select Subscription as the widget type to create a dedicated subscription widget.Widget type selector with Subscription option highlightedWidgets list showing a Subscription widget typeFor full customization options, visit the Widget Customization page.