Skip to main content

Shopify

FlipGive provides a means for fundraisers to raise money through donations, selling merchant offers (such as electronic gift cards, vouchers, and certificates) as well as referral shopping trips to online ecommerce websites.

This document focuses on how to add a Shopify store to be listed as an online shopping option for fundraising teams. FlipGive shopping works much like existing affiliate programs out in the market today.

An online shopping offer is set up on FlipGive, with the merchant agreeing to give a % of purchases made online (before taxes and after discounts) to someone running a FlipGive fundraising campaign. The overall process works like this:

  1. Fundraisers get supporters to visit their fundraising page, they are provided a link to visit the Shopify merchant’s website.
  2. This link embeds a shopper ID and a secure token which contains the related fundraising campaign information and passes this to the merchant’s website.
  3. The merchant captures this information into the visiting customer’s session, and calls FlipGive’s campaign API with the secure token to pull back relevant fundraising information - this is used to display a popup message re-assuring shoppers that a connection was made between FlipGive and their site. In the background, the token is stored on the user’s checkout.
  4. Once the customer makes a purchase, FlipGive is notified via webhook about details of the order and the token on the checkout is matched with the token on FlipGive and the FlipGive user is issued their cashback amount.
  5. FlipGive captures a breakdown of each transaction and financial reconciliation is then handled on a monthly basis with the Shopify merchant.

This document outlines how to integrate the FlipGive Shopify app into your store, as well as how payments are reconciled.

To get started, provide your Shopify domain ending in .myshopify.com to your FlipGive account representative. They will set up your FlipGive merchant and shop link based on the agreed contractual terms. In the FlipGive system, a shop link consists of:

  • Offer details - description of offer displayed to supporters explaining how they can help the fundraising campaign by shopping online
  • Currency - CAD or USD is currently supported
  • Landing page URL - the merchant’s landing page; this can be the merchant’s homepage or a custom landing page greeting fundraising supporters to start shopping
  • Revenue % splits - that occur when a purchase is made. It is set up in the FlipGive administration panel based on the contract.

Step 2: Install FlipGive’s Shopify App (Merchant)​

  1. Visit https://shopify-app.flipgive.com. (Note​: If conducting testing on our staging environment, please visit https://shopify-app.almostflip.com)
  2. Type in your store name and login to your Shopify store

Type in your store name and login

  1. Click “Install unlisted app” (it is unlisted because we haven’t made the app available on the Shopify app marketplace)

Install Shopify app

  1. The installation status page should show all green check marks. If “FlipGive Setup” is not checked off then contact your FlipGive account representative to have them finish setting up your merchant on FlipGive.

Shopify app installation progress

Step 3: Test the integration (FlipGive & Merchant)​

Once the shop link is setup, the final step is to test the integration to ensure that:

  1. The link are being properly received on the Shopify store and the token is properly being unpacked and contents are displayed to the user. You should see the following popup when clicking over from FlipGive to your store.

Popup confirming cashback from FlipGive

  1. Post-purchase, once the item has been shipped - Shopify notifies FlipGive via webhook about the completion of sale and FlipGive records the transaction and allocates the cash back portion to the correct fundraising team.