JeriCommerce integrates with Shopify Flow through 18 event triggers and 8 actions. This guide covers the Shopify-specific setup and features. For the full list of events, payload structure, and event properties, see the Events reference guide.
Turn on event triggers¶
To receive JeriCommerce events in Shopify Flow:
- Go to Settings → Integrations → Shopify.
- Toggle Events on.
- Save your changes.
From that moment, every customer event triggers a Shopify Flow.
Toggle the Events feature on in the Shopify integration settings
Flow trigger handles¶
Each event appears in Shopify Flow as a trigger with a slugified handle. For example, Balance changed becomes balance-changed, and Wallet pass installed becomes wallet-pass-installed.
The naming convention is consistent: lowercase the event name and replace spaces with hyphens. You can find the full list of 18 events in the Events reference guide.
Trigger payload¶
Every trigger sends this data structure to Shopify Flow:
{
"id": "event-uuid",
"customerId": "customer-uuid",
"email": "customer@example.com",
"campaignId": "campaign-uuid",
"url": "https://...",
"browser": "Chrome 120",
"createdAt": "2026-03-08T12:00:00Z",
"properties": { ... }
}
Use the properties object inside your Flow conditions and actions to access event-specific data like amount, rewardTitle, or previous/current tier names. See the full properties reference in the Events reference guide.
Available actions¶
JeriCommerce provides 8 actions you can use as steps inside any Shopify Flow. No need to activate any feature, they are always available.
| Action | Handle | What it does |
|---|---|---|
| Send push notification | send-push-notification |
Send a push notification to the customer's wallet pass |
| Get download link | get-download-link |
Generate a one-time download link for wallet passes |
| Add balance | add-balance |
Add loyalty points to a customer |
| Remove balance | remove-balance |
Remove loyalty points from a customer |
| Assign campaign | assign-campaign |
Assign a campaign or pass to a customer |
| Send gift card | send-gift-card |
Send a gift card coupon to a customer |
| Get customer | get-customer |
Retrieve customer data from JeriCommerce |
| Execute earning flow | execute-earning-flow |
Run a custom earning flow for a customer (e.g. CUSTOM_1) and credit the points defined in the flow |
The Execute earning flow action is the one to use when you want to credit points for something that happens outside JeriCommerce, like a product review being published, a survey response being submitted, or a customer attending an event. Pair it with a custom earning flow set to Tap and external trigger or External trigger only.
