Изменения и версии

Что меняется внутри v1, сколько живут старые версии и что когда изменилось.

Политика версий

• Версия — в пути: /v1/.... api_version вебхуков — v1.
• Внутри версии — только совместимые изменения: новые методы, новые необязательные поля запроса, новые поля ответа, новые события вебхуков, новые коды ошибок и причин, новые значения в полях, описанных как открытые списки (status, kind, reason_code).
• Ваш клиент обязан игнорировать незнакомые поля, а незнакомые коды обрабатывать по HTTP-статусу.
• Несовместимые изменения (удаление или переименование поля, смена типа или смысла) — только в новой версии (/v2). Предыдущая версия работает не меньше 6 месяцев после выхода новой; дату мы сообщаем письмом администраторам всех подключённых организаций и на этой странице.
• Спецификацию OpenAPI текущей версии всегда можно скачать: на английском, на русском.

Журнал изменений

23.10.2026 — v1

Первая публичная версия Partner API:

• расчёты с ценой на 10 минут, слоты доставки, точки забора;
• заказы: создание (идемпотентное, уникальный external_id), пакет до 100, чтение по id или external_id, список с курсорной пагинацией, изменение по правилам И2 4.3, сигнал «собран», отмена с платой, статус оплаты Kaspi QR;
• позиция курьера и ETA (/track), доказательства вручения с временной ссылкой на фото (/proof);
• баланс; адреса вебхуков и подписанные вебхуки (X-Sapa-Signature, HMAC-SHA256) с повторами 24 часа, приостановкой и накоплением событий;
• песочница с виртуальным курьером и пятью сценариями;
• заголовки лимита X-RateLimit-Limit / X-RateLimit-Remaining.

В планах

• POST /v1/pickup-points — создание точек забора через API.
• GET /v1/statements — реестр начислений и зачётов наложенного платежа за период.