Create a Shopify web hook integration

To be able to automatically book donations whenever an order has been paid in your Shopify shop and based on a set of rules, you need to set up an integration program that has a web hook connected to your shop.

Create Shopify API credentials

1. Create a custom app in your Shopify shop: a. go to admin settings b. click Apps and sales channels c. create custom app d. click ‘configure Admin API access scopes’ and add: ‘read_orders’ and ‘read_products’ e. set the API version to 2022-10 and save f. under the ‘API credentials’ tab, klick ‘install app’. Then reveal the Admin API Access Token and copy and save the token in a secure place. Note that you will only be able to access this once, and you will need it for a later step for setting up the actual integration.

Create Milkywire integration

1. Fill out the Shopify integration section of the donation program with: a. Shopify domain (e.g. thisismyshop.myshopify.com) b. API secret key, which you find under the ‘API credentials’ tab on the settings page of your Shopify store. c. Admin API Access Token, which you now should be storing somewhere secure and gotten from when you previously set up your custom store app in Shopify.
2. Add one or more rules that apply. This is what decides when a donation will be created. If you choose to create a rule that’s based on a tag, only products within a purchase - with the specified tag - will generate a donation.

Manage your integration

You can update and toggle your Shopify integration on/off directly in the partner portal.