FlowRelay
Operate
Event lifecycle
Use lifecycle states to understand what FlowRelay has proved. Do not read them as a claim about downstream Shopify Flow actions.
Lifecycle states #
Use lifecycle states to understand the boundary FlowRelay has reached for a specific event.
| State | Meaning |
|---|---|
| Accepted | FlowRelay authenticated and durably stored the event before responding. |
| Queued or processing | FlowRelay is still working toward a terminal handoff result. |
| Delivered | FlowRelay handed the trigger to Shopify Flow. |
| No workflow | FlowRelay could not find a matching enabled Shopify Flow workflow. |
| Duplicate suppressed | FlowRelay identified a repeated external event ID for the same endpoint inside the dedupe window. |
| Replayed | A deliberate second attempt was made from retained event material. |
Retry and reconciliation #
FlowRelay may reconcile accepted events that have not reached a terminal outcome. It does not expose merchant-configurable retry schedules or retry policy controls.
Use the receipt for recovery #
The receipt gives the stable code, replay availability, diagnostics state, and safe next action for the event's current lifecycle state.
Operating guidance
Apply the concept through the receipt before changing setup, resending, or replaying.
- 01Start with the receipt outcome: accepted, delivered, failed, no workflow, duplicate suppressed, or rejected.
- 02Read the timeline to see whether FlowRelay stored the event, queued processing, evaluated duplicate suppression, attempted the Shopify Flow handoff, or recorded a terminal result.
- 03Treat Delivered as the FlowRelay-to-Shopify Flow handoff boundary, not downstream workflow completion.
- 04Treat No workflow as a setup/readiness problem: enable the matching FlowRelay trigger in Shopify Flow, then preview replay while retained.
- 05Treat Duplicate suppressed as a sender retry or repeated external event ID that FlowRelay blocked from a second automatic handoff.
- 06Use the recovery code and safe next action before replaying, resending, or changing endpoint configuration.
Delivered means FlowRelay handed the trigger to Shopify Flow. It does not mean downstream Shopify Flow branches, app calls, fulfillment changes, emails, or later systems completed.