Integration · 2025 – present
Merchant & marketplace APIs
The APIs vendors integrate against: catalogue sync into Magento, orders and stock, and rule-based commission profiles.
The marketplace API is both the backend of the vendor app and the public integration point for vendors who connect their own systems.
Selected parts
Vendor item sync. Vendor items without a Magento ID yet are matched by a constructed SKU-userId key. Existing product images are always kept; matching Magento media IDs are attached without deleting anything. Items that cannot be found are marked lookupStatus: "not_found" instead of failing the batch. Calls run in batches of ten and every failure is retryable.
Stock status endpoint. Operations needed every catalogue record whose stock status Magento changed automatically. Rather than filter on the client or query the database directly, we added a paginated Magento module that exposes exactly that set over REST.
Commission profiles. Commission is a percentage per rule, filtered by brand, Magento category, split features and date range. I reworked the rule format from flat comma-separated strings into structured rules that can be validated and audited.
Bulk operations. Vendors and moderators add and update products in bulk. Since 2026 large batches run in the background on a queue, prices are recalculated when a commission changes, and a monthly job reconciles stock status with Magento.