docs
  1. Advanced
  2. Merchants
  3. Merchant Allocation

Merchant Allocation

Use this page when you need to make a merchant sellable in a shop country.

This page focuses on the rollout sequence. It does not repeat request payloads. For API examples, use Interact with Admin API in Multi-Merchant Setup.

What merchant allocation means

Merchant allocation is the setup that lets a merchant actually sell in a shop country.

That setup combines three things:

  • warehouse availability
  • shop country assignment
  • assortment inclusion

If one of these pieces is missing, the merchant may exist in the system but still not be sellable.

Allocation workflow

1
Choose your setup
Use the single-merchant flow when one merchant sells the catalog.
Use the multi-merchant flow when several merchants can sell the same variants.
2
Connect warehouse capacity
In a single-merchant setup, SCAYLE can create the warehouse on first use and connect it to the default merchant.
In a multi-merchant setup, create the warehouse first. Then connect it to the relevant shop country and merchant.
3
Include the merchant in the assortment
Update the shop country assortment so products from that merchant become sellable.
In multi-merchant setups, this is usually the step people miss.
4
Provide merchant-specific commercial data
Send prices and stocks in the merchant context.
Use merchantReferenceKey for multi-merchant setups.
5
Validate the sellable result
If several merchants sell the same variant, priority decides which merchant wins.
Check assortment, stock, and priority together.

Single-merchant flow

Use this flow when the platform has one merchant only.

You can use the default warehouse assignment path. If the warehouse does not exist yet, SCAYLE creates it and connects it to the default merchant and the target shop country.

In this setup, merchant-specific context is optional in many payloads because the default merchant is implied.

Multi-merchant flow

Use this flow when multiple merchants exist in the same platform.

Follow this order:

  1. Create the warehouse.
  2. Connect the warehouse to the relevant shop country.
  3. Connect the warehouse to the intended merchant.
  4. Update the shop country assortment to include that merchant.
  5. Send prices and stocks with merchantReferenceKey.
  6. Check merchant priority if several merchants sell the same variant.

Multi-merchant issues usually come from missing assortment inclusion or missing warehouse-to-merchant assignment.

Next up
Interact with Admin API in Multi-Merchant Setup