Store sharing
Import another store's products into yours. When a customer buys, your store automatically orders upstream using your balance, receives the card key, and passes it to your customer — all invisibly.
Chains can nest indefinitely — whoever integrates with you can themselves be integrated with. Delivery always originates from the store at the top of the chain.
Connecting to a store
1. Register on their store
Create an account on the store you want to source from, then collect two things from User centre → My profile:
- Merchant ID (
app_id) - Merchant key (
app_key)
2. Add the store
In your own admin panel → Store sharing → Add store. Enter their store address plus the ID and key, and confirm.
3. Import products
Once added, the actions column has a plug icon. Click it to import their products into one of your local categories.
Imported products are disabled by default — adjust prices first, then enable them.
4. Top up your balance
Do not skip this. When your customer orders, the system pays upstream from your balance on their store. No balance means you take the money and cannot deliver.
Recommended:
- Keep a healthy balance upstream
- Install a balance-alert plugin so you are warned before it runs out
If your upstream account has fund operation verification on (it turns on together with two-step verification), first add your server's IP to the integration IP whitelist in the upstream user centre, otherwise integration orders are refused. In the default theme that is the Integration whitelist page; other themes show it on the Two-step verification page. Not sure of the IP? Place one order first: the refused IP shows up under Recently refused below the whitelist, ready to add with one click. Without fund operation verification the whitelist is still worth adding — if your merchant key ever leaks, nobody can spend your balance from another IP. If the upstream still runs 3.8.1 there is no whitelist, and the only option is to turn fund operation verification off.
What happens when a customer orders
- Your customer pays on your store
- Your store places an order upstream with
app_id/app_key, paying from your balance - Upstream delivers (a card key, or via their own delivery plugin)
- The result is stored on your local order and shown to your customer
The customer never sees that the goods came from elsewhere.
Pricing and margin
Your margin is your selling price minus the price upstream charges you.
What upstream charges depends on your member tier on their store — higher tiers pay less. To get a better price, top up there to reach a higher tier, or ask them to adjust your tier directly.
Price synchronisation keeps your local prices tracking upstream changes automatically.
Being the upstream
To let others source from you:
- Enable API access on your products or they cannot be pulled — see products
- Assign each partner an appropriate member tier, which determines their price
- To control the reseller price of a specific product, set per-tier prices under that product's member pricing
Protocol details are in the API reference.
Checklist
| Symptom | Cause |
|---|---|
| Adding the store fails | Wrong address, merchant ID or key; or sharing is not enabled on their side |
| Product list comes back empty | Their products do not have "API access" enabled |
| Customer order errors, nothing delivered | Your balance upstream has run out |
| Order fails with "该账号已开启资金二次验证，必须先登记对接白名单 IP 才能通过对接接口用余额下单。请登录该账号的会员中心，在「对接白名单」（或「两步验证」页）把服务器 IP 加入白名单；被拒的 IP 会列在那里" (fund verification is on, so an IP must be on the integration whitelist before balance orders work) | The upstream runs 3.8.2 or later, your upstream account has fund operation verification on, and its whitelist is still empty. On the upstream Integration whitelist page (in other themes, the Two-step verification page), add your server's IP from Recently refused to the integration IP whitelist |
| Order fails with "调用方 IP 不在该账号的对接白名单内。请登录该账号的会员中心，在「对接白名单」（或「两步验证」页）把服务器 IP 加入白名单；被拒的 IP 会列在那里" (the caller's IP is not on this account's integration whitelist) | The upstream runs 3.8.2 or later, your upstream account has a whitelist, and your server's IP is not on it (after a server move, for example). Add it from Recently refused in the same way |
| Order fails with "该账号已开启资金二次验证，无法通过对接接口消费余额" (the balance cannot be spent through the integration API) | The upstream runs 3.8.1, which has no whitelist. Turn fund operation verification off on the upstream Two-step verification page, or ask the upstream to upgrade to 3.8.2 and use the whitelist |
| Prices higher than expected | Your tier upstream is too low, or they set a specific price for that product |
Markup templates
Markup templates in the admin panel define a reusable markup rule (say, upstream price × 1.2) that you can apply in bulk to imported products, instead of editing prices one at a time.