Skip to content

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.

Store sharing chainStore sharing chain

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 sharingAdd 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

What happens when a customer orders

  1. Your customer pays on your store
  2. Your store places an order upstream with app_id/app_key, paying from your balance
  3. Upstream delivers (a card key, or via their own delivery plugin)
  4. 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:

  1. Enable API access on your products or they cannot be pulled — see products
  2. Assign each partner an appropriate member tier, which determines their price
  3. 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

SymptomCause
Adding the store failsWrong address, merchant ID or key; or sharing is not enabled on their side
Product list comes back emptyTheir products do not have "API access" enabled
Customer order errors, nothing deliveredYour balance upstream has run out
Prices higher than expectedYour 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.

Released under the MIT License