FlowRelay
Use Cases
Recover a failed handoff
Use this path when an event arrived but needs investigation before anyone retries or escalates it.
Why receipts come first #
The receipt is the evidence record. It tells a human or authorized agent what FlowRelay can prove without exposing private request material.
Replay is not automatic #
Replay can trigger downstream Shopify Flow actions. Treat it as an explicit recovery action with preview, authority, and audit.
When to escalate #
Escalate when the receipt or grant says the action is outside the current operator's authority, or when diagnostics are needed for support.
Typical path
A typical path starts from the scenario, then moves into setup and verification.
- 01Open Event history and filter to the endpoint, time window, or outcome you need to investigate.
- 02Open the receipt and read the stable error code, readiness facts, retention state, and handoff status.
- 03Use the error-code guide to decide whether the sender, endpoint, Shopify Flow workflow, or FlowRelay setup needs attention.
- 04Preview replay only when the retained request is still available and the operator understands downstream side effects.
- 05Share diagnostics instead of raw payloads when a partner or support team needs evidence.
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.