Reseller API overview

A JSON-based RESTful API for approved resellers, covering two systems: Buy Now — syndicate your listings onto syntech.co.za so consumers can click through to buy from your store — and Orders — place sales orders directly into Syntech's accounting system and track their status.

Full endpoint documentation, schemas and worked examples live in the API Reference section of this hub.

Authentication

Every call carries a RESELLERTOKEN header with your unique reseller key, issued once onboarding completes. To get access, register your interest at wkf.ms/3vODNhh and our team will revert with next steps.

Environments

UAT and production share the same schema but use different base URLs and tokens. Build and test against UAT first; production credentials are issued at onboarding.

Buy Now — keep your data fresh

Every call returns status: success or failed; bulk updates return success if at least one item was updated, with failures itemised in errors.
A listing with no update for 7 days moves to draft and stops being featured; a further 7 days without an update permanently removes the listing and all its tracking history.
No system access for 3 weeks suspends your reseller account.
Active participants receive a monthly report of clicks per product and the potential value generated.

Orders

Stock is validated against your default location (Cape Town or Johannesburg); collection orders switch to the collection branch. The backorder flag controls whether short-stocked orders are still created. Order lifecycle: ENTERED → COMPLETED (ready for collection, if collecting) → INVOICED (collected, or handed to the couriers — track at tracking.syntech.co.za/track/{order}).

Maintenance windows

Daily offline windows: 23:00–23:30 and 02:00–02:30 SAST — calls during these return an offline status, so build a retry rather than dropping the order.

Error codes

Errors return a code → message map in three families: RC (order creation — e.g. RC9, not enough stock at location), RO (order status lookups) and SC (stock listing updates). The full tables are in the API Reference.