Starshipit
Starshipit is a shipping and fulfillment platform used by many merchants. Starshipit does not read live edits, meaning order changes must be synced before Starshipit downloads the order.
How Starshipit Downloads Orders
Starshipit downloads orders when the payment status is "Paid" in Shopify.
Integration method required: Delayed Payment Capture Flow
How the Integration Works
Order Flow with Order Editing:
Order created → Customer completes checkout
Payment authorized → Payment status remains "Authorized" (not "Paid")
Grace period active → Customer can edit their order (e.g., 30 minutes)
Starshipit does not download → Order not visible because status isn't "Paid"
Grace period ends → Editing window expires
Payment captured → Order Editing captures the payment
Status updates to "Paid" → Order now shows as paid in Shopify
Starshipit downloads order → Order sent to Starshipit with all edits included
Setting Up Starshipit Integration
Step 1: Enable Payment Capture Setting in Shopify
Required for Delayed Payment Capture Flow
Go to Shopify Admin > Settings > Payments
Change Payment capture method from Automatically at checkout to Automatically after fulfillment
Click Save
Why "Automatically after fulfillment"? This allows Shopify Flow to control when payments are captured, creating the editing window while still automating the capture process.
Step 2: Set Up Delayed Payment Capture Flow
Navigate to Shopify Admin > Apps > Shopify Flow
Create or import the Delayed Payment Capture Flow template
Configure the Flow to match your editing deadline (e.g., 30 minutes)
Activate the Flow
Step 3: Configure Starshipit Integration Settings
Critical step required for proper integration
You need to enable Shopify Enhanced Integration in Starshipit and configure which orders to download.
Choosing Integration Version: Classic vs Enhanced
Use CLASSIC if:
Shipping from a single location only
Do NOT offer local delivery methods
Want cleaner order view (merges multiple fulfillment orders into single order)
Use ENHANCED if:
Shipping from multiple locations
Offer local delivery methods
Need split shipments
Need separate fulfillments for each fulfillment order
Step 4: Enable Shopify Enhanced Integration in Starshipit
Log into your Starshipit account
Go to Settings > Integrations
Under Integration Version, select:
Enhanced (if shipping from multiple locations or using local delivery)
Classic (if single location, no local delivery)
Click Save
Step 5: Configure Order Download Settings
Ensure only paid orders are downloaded:
In Starshipit settings, locate Order Status filters
Configure to download only:
PAID orders
Partially Refunded orders
Do NOT download:
Authorized orders
Pending orders
Unpaid orders
Click Save
Why this matters: This prevents Starshipit from downloading orders before the editing window closes.
Step 6: Enable Webhooks
Required for real-time order syncing
Scroll to the bottom of the Starshipit Integrations page
Locate Webhooks section
Click Subscribe to webhooks or ensure webhooks are enabled
Verify webhook status shows "Active" or "Subscribed"
What webhooks do: Allow Shopify to notify Starshipit immediately when orders are ready to ship (payment captured).
Integration Version Details
Classic Integration
Best for:
Single warehouse/fulfillment location
No local delivery options
Simple fulfillment workflows
How it works:
Merges multiple fulfillment orders into one order in Starshipit
Cleaner interface for merchants
Simpler to manage
When Order Editing is used:
Removed items don't create separate fulfillment orders
All changes appear in single consolidated order
Easier to read and process
Enhanced Integration
Best for:
Multiple fulfillment locations
Local delivery methods
Split shipments (items ship from different warehouses)
How it works:
Creates separate fulfillments in Starshipit for each fulfillment order
Skips closed fulfillment orders (e.g., fulfillment orders with only removed items)
Matches Shopify's fulfillment structure exactly
When Order Editing is used:
Removed items create closed fulfillment orders
Enhanced integration skips these closed orders
Only active fulfillment orders sync to Starshipit
Important: Enhanced integration SHOULD automatically skip closed fulfillment orders containing only removed line items.
Known Limitations
Shipping Method Updates Do Not Sync
Issue: If a customer upgrades or changes their shipping method during Order Editing, this change does NOT sync to Starshipit.
Why: Starshipit does not support live shipping method updates from Shopify.
Workaround:
Manually update shipping method in Starshipit after order syncs
Contact Starshipit support to request shipping method sync feature
Impact:
Order will download with original shipping method
Merchant must manually adjust in Starshipit before printing label
Classic to Enhanced Migration Bug (Resolved)
Previous issue: Merchants switching from Classic to Enhanced integration experienced orders downloading regardless of payment status (ignored "Paid only" setting).
Status: Starshipit confirmed this bug was resolved in recent updates (within last 2 weeks as of documentation date).
If you experience this:
Verify you're on latest Starshipit integration version
Contact Starshipit support
Reference "Classic to Enhanced migration financial status bug"
Testing Your Integration
Required Tests:
Before going live, test the following scenarios to ensure Starshipit integration works correctly:
Test 1: Removal of Products
Place a test order with multiple items
During editing window, remove one or more products
Wait for editing period to expire
Verify Starshipit receives order with correct items (removed products should not appear)
If using Enhanced: Verify closed fulfillment orders (with removed items) do NOT appear in Starshipit
Test 2: Addition of Products
Place a test order
During editing window, add a product via upsell
Complete payment for additional item
Wait for editing period to expire
Verify Starshipit shows the added product with correct quantity
Test 3: Shipping Address Changes
Place a test order with Address A
During editing window, change to Address B
Wait for editing period to expire
Verify Starshipit shows Address B (not Address A) on shipping label
Test 4: Payment Capture Timing
Place test order
Check Starshipit immediately → Order should NOT appear
Make edits during editing window
Wait for editing period to expire
Check Shopify Admin:
Payment status should change to "Paid"
Check Starshipit → Order should now appear with all edits
Last updated