Connect Shopify

NinjaBuy works in Shopify the way a fulfillment warehouse does. The app adds a location called Fulfilled by NinjaBuy. Products you set to ship from that location are ours to fulfil: when one sells, Shopify sends us a fulfillment request for those lines, and everything else on the order stays with you. The app only sees the work Shopify assigns to our location, never the rest of your orders.

Because Shopify is the hub, the same app also carries orders from eBay, Amazon, TikTok Shop and the other channels you connect to Shopify with their own apps. See selling elsewhere through Shopify.

• A Shopify store, and a staff account on it that may install apps.
• A NinjaBuy Business account. If you don't have one yet, contact sales.
• Money in your NinjaBuy balance for the first orders. See Add money to your balance.

1. 1
   Install NinjaBuy in your Shopify admin

   Shopify lists the permissions the app asks for and installs it once you approve. There is no separate sign-up page in between.

2. 2
   Open Apps → Fulfilled by NinjaBuy

   The app opens inside your Shopify admin. On the first visit it registers the Fulfilled by NinjaBuy location in your store.

3. 3
   Choose Link account

   A NinjaBuy page opens at ninjabuy.com/connect/shopify with a one-time code that is good for 30 minutes. Sign in to your NinjaBuy account there and confirm. If the code runs out, choose Link account again for a fresh one.

4. 4
   Back in Shopify, the app shows your store as linked

Each Shopify variant we ship needs to know which listing in China to buy. There are two ways to set that up.

New products: push them from the importer

Analyse a Taobao, Weidian or 1688 link in the importer and choose Push to Shopify. The product arrives as a draft, already mapped and already set to ship from Fulfilled by NinjaBuy. Check it and make it active.

Products you already sell: map them in the app

1. 1
   Find the variant in the app's Products list

   Variants without a listing show Not mapped.

2. 2
   Paste the listing's link

   Any Taobao, Weidian or 1688 product link. We read the listing and its variants.

3. 3
   Pick the SKU it should buy

   Choose from the variants we read, such as the colour and size. A SKU we haven't read can't be mapped, so a typo never sends us shopping for the wrong thing.

4. 4
   Set NinjaBuy units per item

   How many of the seller's units make one of yours. A pack of 3 on your store, made of single cups from the seller, is 3.

5. 5
   In Shopify, set the product to ship from Fulfilled by NinjaBuy

   On the product, under inventory, stock it at the NinjaBuy location. Shopify only sends us orders for products stocked there.

Fulfilled by NinjaBuyacme-goods.myshopify.com

Linked to NinjaBuy. “Fulfilled by NinjaBuy” is a location in your store.

Products · 2 of 3 variants mapped

Shopify variant	NinjaBuy listing
Quilted tote · Black SKU QT-BLK	Taobao · 菱格链条包 黑色
Glass cup · Set of 4 SKU GC-4	1688 · 竖纹玻璃杯 4 per item
Bar chair · Walnut SKU BC-WAL	Not mapped

1. 1
   Shopify sends us a fulfillment request

   For the lines stocked at Fulfilled by NinjaBuy. It appears in the app under Orders sent to NinjaBuy.

2. 2
   We accept it, or turn it down with a reason

   We accept a request when every line on it is mapped. If one isn't, we reject the request and the rejection names the lines, so you can map them and request fulfillment again.

3. 3
   We pay from your balance and buy

   The goods, the intake fee and the flat tax come out of your balance. See Fees.

4. 4
   We check it, pack it in your box and ship it

   The QC photos are on the order in your NinjaBuy account before it leaves. See Packaging and QC.

5. 5
   The tracking lands on the Shopify order

   We create the fulfillment in Shopify with the tracking number and link and ask Shopify to notify your customer, so they get your store's usual shipping confirmation email.

Connect a marketplace to Shopify with its own app, and its orders land in your Shopify admin like any other. The ones for NinjaBuy products then reach us through this app. Each guide covers the marketplace's own rules.

Your customer buys from you, not from us, so the store's promises are yours. A few weigh more when the goods come from China.

• No copies of brands
  Shopify's Acceptable Use Policy does not allow selling goods that infringe someone else's trademark. The importer warns you when a listing looks branded.
  Shopify's Acceptable Use Policy↗
• State a delivery time you can keep
  In the US, the FTC expects a reasonable basis for any shipping time you state, and a way to cancel when you can't meet it. Count buying, checking and the trip from China.
  The FTC's mail order rule↗
• Say who pays import duties
  Your customer's country may charge duties or taxes when the parcel arrives. Say so on your store, so nobody is surprised at the door.
• Write returns for goods from China
  Sending an item back to China often costs more than the item. Decide what you refund and what you take back before you list. See returns.

• Uninstalling the app ends our access to your store at once. We keep the link to your NinjaBuy account and your mappings, so a reinstall picks up where you left off.
• Orders we already accepted still ship. Without access we can't write their tracking to Shopify, so reinstall before they leave, or copy the numbers from your NinjaBuy account.
• When Shopify asks us to erase a store's or a customer's data, we delete the buyer addresses we hold for it.