Reseller API overview

🚧
The Reseller API is in beta
It is available to approved resellers by application and is in active development. Endpoints, fields and behaviour may change, and we will give notice of any breaking changes to everyone using it. Build and test against UAT first, and let your account manager know if anything doesn't behave as documented.

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 once you've confirmed UAT testing was successful.

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

Orders placed through the API go straight into our accounting system and don't appear in your order history on syntech.co.za. Keep the salesorder number returned when you create an order: it links the order to your own system, and it's what you use to check the order's status.

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 documented on the endpoints that produce them, in the API Reference.