Connect Shopify
Make every paid order in your Shopify store earn points for the member who placed it. It takes about 20 minutes and you need administrator access to Shopify.
Before you start
- Permissions: Integrations, Creating integration and Editing integration.
- A points programme with a purchase earning rule.
- Your customers are already members of the programme and use the same email or phone in the store. If there is no member, the order is skipped.
1. Create the connector
Go to Integrations › Connectors and click Create New.
- Enter a Name, for example "Online store".
- Choose Integration type › ECommerce and Provider › Shopify.
- Under API secret, enter the secret Shopify uses to sign its notifications. IncentIA uses it to check that the order comes from your store.
- Under Loyalty Programme, choose the programme that receives the points.
- Tick Active and click Save.
Programme and secret
Without a Loyalty Programme, orders are skipped. Without an API secret, IncentIA rejects every notification.
2. Find out the notification address
The screen doesn't show the address Shopify must notify. It has this form:
https://<IncentIA address>/api/webhooks/shopify/<connector number>
Ask support for your account's address and the number of the connector you have just created.
3. Create the notification in Shopify
In the Shopify admin, go to Settings › Notifications › Webhooks and create one webhook for each event in the table. Use the JSON format and the address from step 2.
| Event in Shopify | What IncentIA does |
|---|---|
orders/paid | Awards the order's points |
orders/cancelled | Deducts the points it gave |
refunds/create | Deducts points in proportion to the amount refunded |
IncentIA ignores any other event. A repeated notification doesn't duplicate points.
4. Test with an order
- Place a test order in Shopify with a member's email and pay for it.
- Open Administration › Incoming Webhooks and filter Source › Shopify. The notification should appear.
- Open the member's record: it has the order's points.
Check that it works
- The notification is listed as processed under Administration › Incoming Webhooks.
- The member sees the points in their portal.
- Under Integrations › Connectors, the connector is Active.
If something fails
| Symptom | Likely cause | What to do |
|---|---|---|
| The notification doesn't appear in Incoming Webhooks | Wrong address or inactive connector | Check step 2 and that Active is ticked |
| The notification is rejected | API secret differs from Shopify's | Copy the secret again and save the connector |
| The order is skipped | There is no active member with that email or phone | Ask your customer to use the same email as in the programme |
| The order is skipped with no points | The connector has no Loyalty Programme | Edit it and choose one |
Next steps
- Connect WooCommerce, if you have another store.
- Import and invite members so your customers are already in the programme.
- Reference: eCommerce connectors · Webhooks