Changelog

All notable changes to the Vendor API are listed here, newest first. See Versioning for what counts as a breaking change.

Unreleased — v1

The first public version. Not yet generally available; documentation is published ahead of the API so integrators can review the contract.

Endpoints

• POST /token — exchange credentials for a one-hour bearer token
• PUT /stores/{externalStoreId} — upsert a store, attach a fleet, receive fleet options
• POST /orders — create a delivery request
• GET /orders/{orderId} — current status and full timeline
• POST /orders/{orderId}/cancel — cancel before pickup

Webhook events

• delivery.status_changed
• store.activated
• store.migrating
• store.deactivated
• fleet.payment_overdue

Notes

• Fleet discovery is returned inside the store response; there is no separate endpoint
• Order history is returned inside the status response; there is no separate endpoint
• Failed order requests are never retried by Hızlıyo
• TLS 1.2 or higher is required