Dispatch Lab
Dispatch Lab Integration — Shopify Edited Order Sync (Account Editor)
This guide helps merchants using Dispatch Lab understand how to configure the integration so that Account Editor order edits are always reflected correctly. Dispatch Lab does not read live edits — orders must be fully finalized before Dispatch Lab downloads them.
Authorized state while customers edit, then the Flow captures payment automatically after the grace period — triggering Dispatch Lab to download the finalized order.How the Integration Works
Dispatch Lab downloads orders from Shopify only when payment status is "Paid". The Account Editor Delayed Master Flow creates a grace period between order creation and payment capture — giving you time to edit the order in Account Editor before Dispatch Lab ever sees it.
Step 1 — Order Created
Customer places an order → Payment is Authorized (not yet captured).
Step 2 — Grace Period Active
The editing window opens. Customer or merchant can edit the order in Account Editor — add items, remove items, change quantities, update address.
Step 3 — Dispatch Lab Skips the Order
Because payment status is still Authorized, Dispatch Lab does not download the order. The order is invisible to Dispatch Lab during the entire editing window.
Step 4 — Grace Period Ends
Shopify Flow automatically captures payment → Status updates to Paid.
Step 5 — Dispatch Lab Downloads
Dispatch Lab sees the order for the first time with all edits already included — correct items, quantities, and totals.
Step-by-Step Setup
Step 1 — Enable Manual Payment Capture in Shopify
Set Shopify to hold payment in Authorized state so Dispatch Lab cannot import the order until editing is complete and payment is captured.
- Log in to Shopify Admin
- Go to Settings → Payments
- Scroll down to Payment capture method
- Select "Manually capture payment for orders"
- Click Save
Step 2 — Import the Account Editor Delayed Master Flow
The Account Editor Delayed Master Flow is a pre-built Shopify Flow automation that holds payment capture for a configurable grace period, then captures automatically — triggering Dispatch Lab to download the finalized order.
- Download the Account Editor Delayed Master Flow file (provided with this guide)
- In Shopify Admin, go to Apps → Shopify Flow
- Click Import and select the downloaded
.flowfile - Configure the grace period timing to match your editing deadline (e.g., 30 minutes)
- Click Activate to enable the Flow
- Click Save
Authorized to Paid. Dispatch Lab then downloads the order with all edits included.Step 3 — Disable Shipping Methods App Block in Account Editor
Dispatch Lab does not support shipping method changes during the editing window. To prevent customer confusion, you must disable the Shipping Methods App Block in Account Editor settings.
- Open your Account Editor app settings in Shopify Admin
- Navigate to the App Blocks configuration
- Find the Shipping Methods App Block
- Set it to Disabled
- Click Save
Step 4 — Configure the Editing Deadline
Set how long customers have to edit their order before the grace period expires and payment is captured. This deadline should match the timing configured in the Shopify Flow.
- Open Account Editor app settings
- Find the Editing Deadline setting
- Set the deadline to match your Flow timing (e.g., 30 minutes)
- Click Save
Step 5 — Your Account Editor Workflow
Once setup is complete, this is the automated flow for every order:
- New order arrives → Payment = Authorized (Dispatch Lab does not see it )
- Grace period active → Customer can edit in Account Editor — add/remove items, change quantities, update address
- Grace period expires → Shopify Flow automatically captures payment
- Payment becomes Paid → Dispatch Lab downloads the finalized order
- Order is shipped with all edits included — no manual intervention needed
What happens after this setup:
- Correct order total — removed items not counted
- Added items appear correctly in Dispatch Lab
- Quantity changes reflected accurately
- Address changes included in the download
- No manual payment capture needed — fully automated
Settings Summary
| Where | Setting | Value |
|---|---|---|
| Shopify → Settings → Payments | Payment capture method | Manually capture payment for orders |
| Shopify → Apps → Shopify Flow | Account Editor Delayed Master Flow | Active — grace period configured |
| Account Editor → App Blocks | Shipping Methods App Block | Disabled |
| Account Editor → Settings | Editing Deadline | Configured (e.g., 30 min) |
Testing Checklist
Before going live, run through this checklist to confirm everything works correctly:
- Place a test order — verify it does not appear in Dispatch Lab immediately
- Make edits during the editing window — add/remove items, change address
- Wait for the grace period to expire
- Confirm payment is captured automatically by the Flow
- Confirm order appears in Dispatch Lab with all edits included
- Verify shipping method changes are blocked (App Block disabled)
Troubleshooting
| Issue | Likely Cause | Fix |
|---|---|---|
| Orders appearing in Dispatch Lab too early | Payment capture not set to Manual, or Flow not activated | Verify payment capture = "Manually capture payment for orders" and the Account Editor Delayed Master Flow is Active |
| Orders not appearing after grace period | Flow is not capturing payment correctly | Open Shopify Flow → check the run history for errors → re-import if needed |
| Edits not reflected in Dispatch Lab | Edits were made after the grace period ended | Ensure all edits are completed before the grace period expires — Dispatch Lab does not read live edits |
| Customer changed shipping method | Shipping Methods App Block is still enabled | Disable the Shipping Methods App Block in Account Editor settings |
| Authorization expired (no payment captured) | Grace period exceeds 7-day limit | Reduce grace period to well under 7 days (recommended: 30 min – 2 hours) |
Best Practices
- Keep the grace period short — 30 minutes to 2 hours is ideal for most stores
- Always disable the Shipping Methods App Block — Dispatch Lab cannot process shipping changes
- Sync the editing deadline in Account Editor with the Flow timing so customers see an accurate countdown
- Monitor Shopify Flow run history after launch to confirm payment captures are firing correctly
- Test the full flow end-to-end before going live with real orders
Need Help?
If orders still don't sync correctly after following this guide, contact Account Editor Support and share:
- Your store URL
- Screenshot of Shopify → Settings → Payment capture method
- Screenshot of Shopify Flow → Account Editor Delayed Master Flow status and run history
- The affected order number