Skip to content

Shopify Integration

Doover offers the abilty to integrate a new or existing Shopify store with your Doover organisation.

Benefits include:

  • Shopify payment processing managed through your existing Doover Stripe account
  • Shopify orders can be linked to and provisioned through Doover
  • Doover can display your products as "ads" in the Doover app.

Getting Started

This guide will walk you through the steps to integrate your Shopify store with Doover. It should take less than an hour.

Prerequisites

  • A Shopify shop (must be on a Basic (or higher) plan, with admin access
  • A Doover account, also with admin access for your organisation.

Step 1: Retrieve your shopify domain

This step may be slightly different depending on your store setup.

Either way, a shopify domain should take the form of:

xxxxxx.myshopify.com

There are a few ways of finding your shopify domain:

  1. If you haven't set a custom domain, the domain can be found in the top left corner of the Shopify Admin Page. no_custom_domain_get_domain.png
  2. If you have set a custom domain, you can find the shopify domain by navigating to the "Domains" tab in the Shopify Admin Page: custom_domain_get_domain.png
  3. If you're still unsure, reach out to the Doover team.

Step 2: Create a Webhook Notification

Next, we're going to create a new webhook notification. This allows Doover to be notified whenever a customer places an order so that we can add the order to the customer's Stripe invoice.

webhook_page.png

The event we're looking for is an Order creation, you need to point the webhook URL to https://my.doover.com/shopify/order-creation (NOT your own customer site), and select the 2024-07 version of the API.

create_webhook.png

Finally, take note of the "Webhook Signing Key", as we will enter this later on the Doover site.

webhook_signing_key.png

Step 3: Create a Shopify App

select_app_menu_create.png

You may need to allow custom app development allow_custom_app.png allow_custom_app2.png

Next, create a new app: create_app_name.png

Step 4: Configure API permissions

Next, we're going to configure some API credentials. This is necessary for Doover to manage orders for you (assigning tags, etc.), and to access products for Ad display.

We'll start off with the Admin API Integration. configure_admin_api_button.png

Firstly, allow write_products and read_products permissions. You'll also need to allow read_orders and write_orders permissions.

allow_readwrite_products.png

The Selected page should show 4 permissions selected. You can now save, as shown below.

configure_api_perms.png

Next, we're going to configure the Storefront API Integration. This is necessary for Doover to display your products as ads.

You should allow access for unauthenticated_write_checkouts, unauthenticated_read_checkouts, and unauthenticated_read_product_listings.

configure_storefront_api.png configure_storefront_api2.png

You should now see the following permissions granted on the "Configuration" tab. configure_permissions.png

Step 5: Installing the App and retrieving API tokens

Before going any further, we now need to install the app. This doesn't do much, but it does allow us to generate API tokens that we need.

install_app.png

You should now be able to click "Reveal Token Once" and see the following screen. DO NOT LEAVE THIS PAGE!!

show_tokens.png

Step 6: Configure Doover

Now that we have our API tokens, webhook signing key and shopify domain we can configure the shop on the Doover site.

In the admin page, navigate to "Shops" and click "Add Shop".

doover_add_shop.png doover_shop_parameters.png

Enter the values you obtained from the Shopify app in the previous steps, and click "Save".

Next Steps

And that's it! Your Shopify store is now integrated with Doover. You can now configure product ads through the "Ads" admin page on the doover admin site.

We also suggest changing the email input box on the checkout page to specify that the email must match your Doover account, and setting up manual payments. See the manual payments and email title pages for more information.