Ссылки отслеживания

Страница отслеживания под вашим брендом для получателя и позиция курьера для ваших экранов.

Страница отслеживания

У каждого заказа есть tracking_url (https://parcel.sapamoto.kz/t/<токен>): страница для получателя — без регистрации, работает на любом телефоне. Токен случайный (256 бит), а не номер заказа, поэтому ссылки не подобрать.

На странице:

• ваш бренд (название, логотип, цвет — настраиваются в кабинете) и «доставляет Sapa Moto»;
• статус простыми словами — готовим, ищем курьера, курьер едет за заказом, в пути, курьер у вас, доставлено — на казахском или русском;
• окно доставки и после забора — ETA с округлением до 5 минут;
• карта с курьером — только от забора до вручения и только когда ваш заказ — следующая точка курьера;
• имя курьера и транспорт (без фамилии и телефона), звонок через маску;
• delivery_code, который нужно назвать курьеру, сумма к оплате при получении;
• детали, которые получатель может уточнить (подъезд, этаж, домофон), пока курьер не приехал, и оценка после вручения.

Через 7 дней после финального статуса страница показывает только, что доставка завершена.

Сообщения получателю

Ссылку мы отправляем в WhatsApp (SMS — запасной канал) по вашим настройкам в кабинете:

Не больше пяти сообщений на точку доставки. Можно отправлять tracking_url и самим — в вашем приложении, SMS, письме.

Позиция курьера в вашем интерфейсе

GET /v1/orders/{id}/track возвращает последнюю позицию и ETA:

{
  "order_id": "0192f1b2-6d4e-7a10-b3c2-8e1f0d9a4c57",
  "status": "to_dropoff",
  "latitude": 43.2264,
  "longitude": 76.9043,
  "position_at": "2026-10-24T09:41:55Z",
  "eta": "2026-10-24T09:52:00Z"
}

• Позиция видна, пока курьер везёт заказ; до забора latitude / longitude равны null.
• Не чаще раза в 10 секунд на заказ — иначе 429.
• Позиция никогда не отправляется вебхуками; о сдвиге ETA сообщает order.eta_changed.