English source · 2 min
Veyndo Marketplace Studio
Connect Amazon, eBay and Kaufland to a commerce host. Map product fields, maintain channel-specific content and images, synchronize offers and review imported orders. The same Rust provider code powers Marketplace Studio inside Veyndo Commerce.
This repository owns the provider gateway, manifest, Studio views, container and
tests. Its history was extracted from veyndo/veyndo, recorded in
PROVENANCE.json. Changes belong here; Veyndo consumes a pinned,
verified source snapshot so ordinary clones and existing frontend builds work.
Build and run
cargo build --locked --release
APP_TOKEN='<server gateway token, at least 24 characters>' \
APP_MARKETPLACE_TENANTS='<approved host and seller configuration>' \
target/release/marketplace-gateway
# Or: docker build -t veyndo-marketplaces .
The component needs no Core source or database credentials. It calls its approved host for durable records/jobs, current product/channel data and atomic paid-order intake. Read the host contract before connecting another platform. The existing Veyndo setup and merchant workflow contains the operator configuration and seller prerequisites.
The bundled Studio views integrate with Veyndo's existing UI host. A separately embeddable frontend package and independent durable host adapter remain planned.
HTTP, MCP and JavaScript
The server exposes /health, /actions/{action}, /events and /mcp. HTTP and
MCP share actions and effects. MCP schemas come from the manifest; all record actions and idempotent sync share
the same host delegation. hostPath supports independent commerce hosts. Only trusted
server gateways may use the service credential; browser/user clients go through
the host's current permissions and installation consent.
Run the JavaScript example with Node 22 or newer:
npm ci --ignore-scripts
MARKETPLACE_URL=https://marketplaces.example.com \
MARKETPLACE_TOKEN='<private gateway token>' MARKETPLACE_TENANT=your-shop \
MARKETPLACE_LISTING=your-offer node examples/prepare.mjs
Verify
cargo test --locked
cargo build --locked
npm ci --ignore-scripts
npm test
Eight Rust tests exercise mapping, exact currency, provider prerequisites, source addresses, event admission and fixed provider origins. The standalone test starts the real binary with an independent host and exercises HTTP/MCP/SDK, shared state, wrong credentials, foreign tenants, rejected imports and language inheritance. It makes no external provider requests. CI also checks the production container.
tests/integration.py is the connected Veyndo/PostgreSQL/provider-fixture suite.
Run it through python3 scripts/marketplaces.py in the Veyndo composition, or set
VEYNDO_ROOT to its absolute checkout when running the fixture from this repository. It
covers listing sync, paid import, replay/restart, stock, documents and permissions.
Its fixture results do not certify live seller accounts or category schemas.
Licensed under the original Sustainable Use License.