Доказательства вручения
Как заказ был вручён — код получателя, фото, геоточка и время.
У каждого заказа есть 4-значный delivery_code (в ответе POST /v1/orders и в GET /v1/orders/{id}). Получатель
видит его в SMS / WhatsApp со ссылкой отслеживания и называет курьеру; без кода курьер не может завершить вручение
(или без фото, если код использовать нельзя).
Когда заказ delivered:
curl
curl https://partner.sapamoto.kz/v1/orders/SHOP-100245/proof -H "Authorization: Bearer $SAPA_KEY"200 OK
{
"order_id": "0192f1b2-6d4e-7a10-b3c2-8e1f0d9a4c57",
"method": "code_and_photo",
"photo_url": "https://api.sapamoto.kz/api/v1/public/partner/proof-photos/MDE5MmYx…",
"photo_url_expires_at": "2026-10-24T10:15:00Z",
"code_verified": true,
"latitude": 43.21402,
"longitude": 76.88011,
"delivered_at": "2026-10-24T09:53:10Z",
"cod": { "amount_tiyn": 500000, "method": "cash" }
}| Поле | Что это |
|---|---|
method | code, photo или code_and_photo |
code_verified | код получателя проверен |
latitude, longitude, delivered_at | где и когда курьер подтвердил вручение |
photo_url | временная ссылка на фото, действует 15 минут (photo_url_expires_at) |
cod | принятый наложенный платёж, если был |
Если фото нужно хранить, скачайте его сразу — ссылка истекает через 15 минут. За новой ссылкой снова вызовите
GET /proof. До вручения метод возвращает 404.
Те же доказательства (без ссылки на фото) приходят в вебхуке order.delivered.
Чего мы не передаём
Доказательства, заказы и вебхуки содержат имя курьера, телефон через маску или виртуальный номер и транспорт — никогда ИИН, документы и настоящий телефон курьера.