> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.accounteditor.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Starshipit

### Starshipit Integration — Shopify Edited Order Sync (Account Editor)

###### This guide helps merchants using **Starshipit** configure the integration so that Account Editor order edits are always reflected correctly — with no mismatched totals or stale order data.

---

### Step-by-Step Configuration

## **📋 Step 1 — Enable Manual Payment Capture in Shopify**

###### Set Shopify to hold payment in **Authorized** state so Starshipit cannot import the order until editing is complete and payment is captured.

1. Log in to **Shopify Admin**
2. Go to **Settings → Payments**
3. Scroll down to **Payment capture method**
4. Select **"Manually"** — Authorize payment at checkout and capture manually
5. Click **Save**

|| **⚠️ 7-day limit: Shopify Payments authorizations expire after 7 days. Always capture payment within this window after editing is complete.**

---

## **📋 Step 2 — Open Settings in Starshipit**

###### Log in to Starshipit and navigate to **Settings** at the bottom of the left sidebar.

1. Log in to **Starshipit** at app.starshipit.com
2. Click **Settings** at the bottom of the left sidebar

![](https://storage.crisp.chat/users/helpdesk/website/-/e/5/a/f/e5af1a5ea93f4000/settings-sidebar_49i9m9.png)

---

## **📋 Step 3 — Open Integrations**

###### Inside Settings, find the **Connect** section and click **Integrations**.

1. In the Settings sidebar, scroll to the **Connect** section
2. Click **Integrations**

![](https://storage.crisp.chat/users/helpdesk/website/-/e/5/a/f/e5af1a5ea93f4000/settings-integrations_m7odp9.png)



---

## **📋 Step 4 — Add Your Shopify Store (First Time Setup)**

###### Only needed if Shopify is not connected yet. If you have not connected your Shopify store, you will see "You have no current integrations". Click **Add a new integration** to connect your store.

1. On the Integrations page, click **"+ Add a new integration"**
2. From the eCommerce Platform list, click **Shopify**
3. Choose **Integration Version** — select **Enhanced** for best compatibility
4. Enter your **Shop Name** (e.g. `your-store-name` from your-store-name.myshopify.com)
5. Click **Authorize** — you will be redirected to Shopify to approve the connection
6. Click **"Test to ensure it works"** to verify the connection

![](https://storage.crisp.chat/users/helpdesk/website/-/e/5/a/f/e5af1a5ea93f4000/add-new-integration_1bmwy4s.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/e/5/a/f/e5af1a5ea93f4000/shopify-selected_pms3xu.png)

|| **📝 Enhanced vs Classic: Choose **Enhanced** for improved fulfillment location support, Shopify tags, and multi-location shipping. Enhanced is recommended for all new setups.**


---

## **📋 Step 5 — Set Status to Import = Paid Only**

###### If Shopify is already connected, click **Settings** next to your store on the Integrations page. Then set **"Status to import"** to **Paid** only. This ensures Starshipit skips all Authorized orders and only imports when payment is captured.

1. On the Integrations page, click **Settings** next to your Shopify store
2. Find the **"Status to import"** section
3. Click the dropdown — currently shows **Any** or **Open**
4. Select **Paid** only
5. Click **Save**

![](https://storage.crisp.chat/users/helpdesk/website/-/e/5/a/f/e5af1a5ea93f4000/image_s7yozd.png)

/
![](https://storage.crisp.chat/users/helpdesk/website/-/e/5/a/f/e5af1a5ea93f4000/image_11l80ot.png)

|| **📝 With **Paid only** selected, Starshipit will completely ignore any order with `Authorized` payment status — giving you a clean, uninterrupted window to edit the order in Account Editor before capturing payment.**

---

## **📋 Step 6 — Edit Order in Account Editor, Then Capture Payment**

###### Once setup is complete, follow this workflow for every order:

1. New order arrives → Payment = **Authorized** *(Starshipit skips it ✅)*
2. Open order in **Account Editor** — add or remove items freely
3. **Save / commit** your edits in Account Editor
4. Go to **Shopify Admin** → open order → click **Capture Payment**
5. Payment becomes **Paid** → Starshipit imports the final correct order ✅

###### **What happens after this setup:**

* ✅ Correct order total — removed items not counted
* ✅ Added items appear correctly in Starshipit
* ✅ Quantity changes reflected instantly
* ✅ Shipping method updates supported
* ✅ If you edit after import (before dispatch) — Starshipit auto re-imports the updated order

|| **✅ Setup complete! Starshipit will always receive the final, correctly edited order. Unlike other WMS apps, even post-import edits sync automatically before dispatch.**

---

### Automate Payment Capture with Shopify Flow

###### Instead of manually capturing payment on every order, set up a Shopify Flow automation to manage capture while giving you a short review window for normal Online Store orders.

### **Step 1 — Trigger**
###### A new order is created in your store.

### **Step 2 — Condition 1: Sales Channel Check**
###### The flow checks whether the order came from the **Online Store**.
* If **NOT from Online Store** (e.g. POS or draft order) → capture payment immediately
* If from Online Store → continue to the next check

### **Step 3 — Condition 2: Fraud Risk Check**
###### Shopify's fraud analysis checks the order risk level.
* If risk level is **HIGH** → capture payment immediately (review these orders manually)
* If risk is not HIGH → continue to the next check

### **Step 4 — Condition 3: Restricted Tag Check**
###### The flow checks whether the order is tagged `restricted`.
* If tagged **"restricted"** → capture payment immediately
* If not restricted → wait **15 minutes**, then capture payment

## **Flow Summary**

| **Scenario** | **Action** |
| ---- |
| Order from other channels (not Online Store) | Capture immediately |
| Online Store + HIGH risk | Capture immediately |
| Online Store + tagged "restricted" | Capture immediately |
| Online Store + normal order | Wait 15 min, then capture |

|| **📝 Why the 15-minute delay? The wait gives you a short window to review normal, low-risk Online Store orders before payment is finalized. This helps with last-minute cancellations or manual edits in Account Editor before Starshipit imports the order.**

---

### Common Issues & Fixes

| **Issue** | **Likely Cause** | **Fix** |
| ---- |
| Starshipit imports order before editing is done | Status to import includes "Open" or "Any" | Change Status to import = "Paid" only |
| Orders not appearing after payment capture | Auto import disabled | Settings → Integrations → check "Automatically import orders from all integrations" |
| Edited order not updating in Starshipit | Order already dispatched | Always edit before dispatch — edits sync automatically only for undispatched orders |
| Authorization expired before capture | 7-day window missed | Capture payment within 7 days of order placement |
| Connection test fails on setup | Wrong shop name or permissions not granted | Re-enter shop name exactly as shown in your Shopify URL → click Authorize again |

---

### Best Practices

* Always set **Status to import = Paid only** — never leave it as Open or Any
* Use **Enhanced** integration version for best Shopify compatibility
* Edit orders in Account Editor **before capturing payment** for the cleanest workflow
* Even post-import edits work in Starshipit — but always edit before dispatch to avoid label reprinting
* Enable **"Automatically import orders"** in Import Settings for orders to sync every 20 minutes

---

### Need Help?

###### If orders still don't sync correctly after following this guide, contact Account Editor Support and share:

* Your store URL
* Screenshot of Starshipit → Integrations → Shopify Settings
* Screenshot of Shopify payment capture setting
* The affected order number