For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

The Integrations page in DollarBack. The Marketing and automations section shows cards for Klaviyo and Omnisend (both Connected) and Shopify Flow (Enabled), each with a Manage button, and cards for Mailchimp and Judge.me (Not Connected) with a Set up button.
Every integration starts on the Integrations page. Click Set up on the card you need. Once it is connected, the button reads Manage.

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.

Trigger
Fires when
Fields

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

The Shopify Flow page in DollarBack. The Shopify Flow Integration card shows an Enabled badge and a Disable button. Below it, the Flow Triggers card has Current and Deprecated tabs and lists the triggers in sections, starting with Store credit. The Store Credit Credited row is open and shows its fields: amount, formattedAmount, currency, symbol, reason, expiresAt, formattedExpiresAt, expiryDays, orderId, orderName and offerTitle.
The Shopify Flow page in DollarBack lists every trigger it adds to Flow, grouped by section. Open a row to see its fields under their variable names.

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}}. orderId and orderName keep 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 then 0.

  • 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's CA$ for Canadian dollars.

  • Empty fields. Flow needs every field on every run, so a field that doesn't apply arrives empty (or 0 for a number). For example, a signup reward has no orderId or orderName.

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 0 for credit that never expires. It's now the date only, and empty for credit that never expires. A condition that tests Expires At equal to 0 no longer matches; test Expiry Days equal to 0 instead.

  • 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.

Action
What it does
Fields

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.5 means 2 days.

  • Expires At is an exact expiry date to use instead of Expires After. Enter 2026-12-31 (the end of that day) or 2026-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 Flow Actions card in DollarBack with Current and Deprecated tabs, listing Deposit Store Credit v2 and Deduct Store Credit v2 with every field each one takes.
The Flow Actions card lists the two v2 actions and their fields. The Deprecated tab lists the older actions.

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.

  1. In Shopify Flow, click Create workflow.

  2. Select a trigger → choose Store Credit Credited (under DollarBack).

  3. Add a Condition: Amount is greater than 50.

  4. On the "then" branch, add an Action → Add customer tags → enter vip.

  5. 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 advocate to 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).

Last updated