Shopify Flow: triggers & actions
This article's section starts at 0:00 in the video.
DollarBack plugs into Shopify Flow with triggers (react when credit moves, a code is issued, or a tier changes) and two actions (move credit from your own workflows), so you can automate tagging, messaging, and even credit itself without code.
Prerequisites
The Shopify Flow app installed on your store.
A DollarBack plan that includes Klaviyo, Omnisend, Mailchimp and Flow integrations. On other plans the Shopify Flow page shows Upgrade to Enable instead of Enable, with the banner "Integrations aren't available on your current plan." Click it to compare plans on the Billing page (Choose a plan and start your trial).
The Flow integration enabled: go to DollarBack admin → Integrations, click Set up on the Shopify Flow card, then click Enable. The badge changes to Enabled. No account connection or authentication is needed.

Triggers
Triggers start a workflow when DollarBack does something. Each carries the customer plus the fields below, which you can use in conditions and later steps.
Store Credit Credited
Credit is added to a customer: order cashback, a signup, newsletter, social, review or custom reward, a merchant API or CSV credit, or a Flow deposit
Amount, Currency, Formatted Amount, Symbol, Reason, Expires At, Formatted Expires At, Expiry Days, Offer Title, orderId, orderName
Store Credit Redeemed
A customer spends credit at checkout, and whenever credit is taken off a balance: a refund, cancellation or order-edit clawback, a merchant API or CSV debit, or a Flow deduction
Amount, Currency, Formatted Amount, Symbol, Reason, orderId, orderName
Birthday Reward Credited
A birthday reward is granted
Amount, Currency, Formatted Amount, Symbol, Reason, Expires At, Formatted Expires At, Expiry Days, orderId, orderName
Store Credit Expiring
A customer's credit is about to expire, at the reminder thresholds from your Expiry Notification Schedule
Amount, Currency, Formatted Amount, Symbol, Reason, Expires At, Formatted Expires At, Remaining Days, Transaction Id
Referral Reward Credited
A referrer earns credit because a friend ordered with their code
Amount, Currency, Formatted Amount, Symbol, Reason, Expires At, Formatted Expires At, Expiry Days, Referee First Name, Referee Last Name, orderId, orderName
Discount Code Credited
A customer gets a discount code, earned from a program or claimed in the reward marketplace
Discount Code, Reward Summary, Offer Title, Reason, Amount, Formatted Amount, Currency, Symbol, orderId, orderName
Discount Code Expiring
An unused reward discount code is about to expire
Discount Code, Reward Summary, Offer Title, Reason, Expires At, Formatted Expires At, Remaining Days
Customer Tier Upgraded
A customer moves up a tier, or reaches their first tier
Tier, Previous Tier (empty for a first tier), Reason
Customer Tier Downgraded
A customer moves down a tier, or loses their tier
Tier (empty when they lost their tier), Previous Tier, Reason

How the fields work:
In a Flow template, each field is a camelCase variable. Flow shows Formatted Expires At in its picker; in an action field that takes Liquid you write
{{formattedExpiresAt}}.orderIdandorderNamekeep those names.Reason says why the trigger fired, for example Order Cashback, Signup Bonus, Review Reward, Manual Credit, CSV Import Credit, Shopify Flow Deposit, Order Redemption, Order Refund, Order Cancelled, Order Edited, Manual Debit, CSV Import Debit, Shopify Flow Deduct, Referral Reward, Birthday Reward, Scheduled Expiry or Tier Evaluation.
Expires At is the expiry date in your store's time zone (for example
March 5, 2027). Formatted Expires At adds the time and zone (March 5, 2027 at 3:07 AM EST). Both are empty when the credit never expires, and Expiry Days is then0.Formatted Amount uses the same money format as your emails and the merchant API:
$36.85,¥1,000,CA$10.33. Symbol follows it, so it'sCA$for Canadian dollars.Empty fields. Flow needs every field on every run, so a field that doesn't apply arrives empty (or
0for a number). For example, a signup reward has noorderIdororderName.
What changed in October 2026
Existing workflows keep running: the trigger handles didn't change. But check any workflow built on the old fields:
Two triggers were renamed in Flow: expiryThreshold is now Store Credit Expiring, and Reward Credit Credited is now Referral Reward Credited.
Expires At used to be a date and time, or
0for credit that never expires. It's now the date only, and empty for credit that never expires. A condition that tests Expires At equal to0no longer matches; test Expiry Days equal to0instead.The old fields are still sent but deprecated: eventType (use Reason; it carries the same value) and Remaining Days Before Expiry (use Remaining Days). The Deprecated tab on the Shopify Flow page lists them.
Actions
Actions let any Flow workflow move credit, whatever its trigger: an order event, a customer tag change, a schedule.
Deposit Store Credit v2
Adds store credit to the customer in the workflow
Amount, Currency, Expires After, Expires At, Offer Title, Notify Customer, Send to Integration
Deduct Store Credit v2
Removes store credit from the customer
Amount, Currency, Offer Title, Notify Customer, Send to Integration
Offer Title is the label shown in your credit logs for this movement.
Notify Customer sends the customer an email if that template is enabled: Store Credit Credited for a deposit, Store Credit Debited for a deduction. See Email notifications overview.
Send to Integration forwards the event to your connected integrations, such as Klaviyo and Omnisend.
Expires After is a number of days. A decimal rounds up to the next whole day, so
1.5means 2 days.Expires At is an exact expiry date to use instead of Expires After. Enter
2026-12-31(the end of that day) or2026-12-31T18:00(that time). Without a time zone offset, the value is read in your store's time zone. It must be at least an hour in the future, and you can fill in only one of the two fields. Leave both empty for credit that never expires.

The older Deposit Store Credit and Deduct Store Credit actions are deprecated: Flow labels them "Deprecated: use … v2 instead". Workflows that use them still run, but they have no Offer Title, Notify Customer or Send to Integration field: they always email the customer and always forward the event. Use the v2 actions in new workflows.
If the decision to move credit lives in your own backend rather than in a Flow workflow, the /credit and /debit endpoints in the Merchant API do the same job from a server call, and report the new balance back to you.
Worked recipe: tag big earners
Goal: when a customer earns more than $50 of credit in one go, tag them for a VIP segment.
In Shopify Flow, click Create workflow.
Select a trigger → choose Store Credit Credited (under DollarBack).
Add a Condition:
Amountis greater than50.On the "then" branch, add an Action → Add customer tags → enter
vip.Name the workflow and turn it on.
Now credit a test customer $51 or more (a qualifying order or a manual credit) and watch the tag appear on their customer page.
Other recipes that work well:
Store Credit Expiring → send marketing email/SMS via your connected platform for a last-chance nudge.
Referral Reward Credited → add customer tags
advocateto build a referrers segment.Customer Tier Upgraded → add customer tags with the tier name, to target each tier in Shopify segments.
Order paid (Shopify trigger) + Deposit Store Credit v2 for one-off promotions DollarBack's programs don't cover, e.g. a flat $5 for orders containing a specific product.
Customer tag added → Deduct Store Credit v2 to zero out balances when you flag abuse.
Customer abandons checkout (Shopify trigger) → Add customer tags or Deposit Store Credit v2 to win back shoppers who left checkout. Three tested setups, for stores with and without tiers, are in Win back abandoned checkouts with cashback.
Verify it works
Open the workflow's run history in Flow after triggering it. Each run shows the trigger payload and whether every step succeeded. Then check that the credit really moved: open DollarBack admin → Analytics → Activity. A deposit is on the Credits earned tab and a deduction on the Credit spent tab. A step that succeeded in Flow with no row here means the Flow integration is disabled.
Common issues
The DollarBack triggers don't appear in Flow: check that DollarBack is installed on the store, then reopen the Flow editor.
The DollarBack triggers appear but never start a workflow: the Flow integration is disabled in DollarBack (see the warning under Prerequisites).
A workflow fired, every step shows success, but no credit moved: the Flow integration is disabled in DollarBack. Enable it on DollarBack admin → Integrations → Shopify Flow. DollarBack doesn't replay the skipped deposits, so run them again (or credit the customers by hand) after you enable it.
A workflow fired but the action shows an error: check the run history for the message; Amount must be a number above 0 and Currency a valid code.
A workflow on Store Credit Redeemed runs after refunds or manual debits: that trigger fires for every debit. Add a condition on Reason (see the hint under Triggers).
A condition on Expires At stopped matching: the field changed format in October 2026 (see What changed in October 2026).
The expiry trigger never fires: you need at least one threshold in the Expiry Notification Schedule and credit that actually expires (Credit expiry and reminders).
Related articles
Last updated