Skip to main content

Set up your Shopify App

Are you ready to give back and make a difference with your business? With our easy-to-use Shopify integration, you can set up automatic donations based on your sales and fundraise for a specific cause. No need to be a developer, just follow these steps below to get started.

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​

Create a custom app in your Shopify shop:

  1. Go to admin settings
  2. Click Apps and sales channels 
  3. Create custom app
  4. Click ‘configure Admin API access scopes’ and add: ‘read_orders’ and ‘read_products’ 
  5. Set the API version to 2022-10 and save
  6. 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

You will only be able to access this once, and you will need it for a later step for setting up the actual integration.

Shopify credentials

Create a Milkywire integration​

Creating a new integration​

Once logged in to the Partner Portal, navigate to Solutions and scroll down to the Avaliable solutions section. Click on New donation integration button, to create a new integration.

scaleYourImpact

Set defaults​

  • Set up your integrations based on your preferences.
  • Name your integration*
  • Set a default currency and default cause(s)

You can choose one or up to five different causes: Climate change, Oceans and seas, Wildlife, Environmental defenders and Forests and landscapes.

When done just click the Create button at the bottom right.

note
  • The name of your integration will be displayed to end users when following up on their donations.

New integration

Enable your Shopify integration​

Fill out the Shopify integration section of the donation program with:

  1. Shopify domain (e.g. thisismyshop.myshopify.com) 
  2. API secret key, which you find under the ‘API credentials’ tab on the settings page of your Shopify store.
  3. 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.

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.

Shopify toggle

Manage your integration​

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