Seller guide
Build a curated shelf — listings, shelf prices and sales channels.
Seller guide
You are a Seller if you curate a shelf: you pick offers from the network, layer your own shelf price, and expose them through your sales channels.
What you build
| Step | Guide |
|---|---|
| Create a listing on a network offer | Create a listing |
| Set your shelf price | Shelf price |
| Publish to your channels | Channels |
The shape of a Seller's data
- Listing — your shelf entry, pointing at an offer you are permitted to sell.
- Shelf price — your retail-facing price; independent of the offer's
seller_price. - Channel — a storefront/tenant your listings appear in.
Minimal flow
1. GET /v1/offers?… → find offers your entity is permitted to see
2. POST /v1/listings → layer a shelf price on a permitted offer
3. POST /v1/channels/{id}/publish → make listings visible in a channel
What you can and cannot see
You only ever receive offers that pass your entity's permissions — network_shareable, allowed_countries
and named_sellers are applied before you get any row. You cannot enumerate the network's full offer table.
See Data-exposure controls.