Список значимых изменений API. Версии — в semver. Для breaking changes — отдельный entry с миграционным гайдом.
2026-05-11
Display-mode для POS-планшета
https://paybot.kz/checkout/{token}?display=1 — полноэкранный режим страницы оплаты для кассового планшета или экрана. QR обновляется автоматически, лишний UI скрыт, статус «Оплачено» показывается крупно.
Native Kaspi backend
Под капотом PayBot перешёл с Java OkHttp-прокси и эмулятора Android на нативный Python-клиент Kaspi API. Снизились задержки (median 350ms → 120ms), пропала зависимость от Android. SMS-онбординг Kaspi-аккаунта занимает 3 шага вместо 9.
Wave 2: модернизация webhooks
- •Ротация секрета без удаления webhook:
POST /me/webhooks/{id}/rotate-secret - •Disable / enable без потери истории:
POST /me/webhooks/{id}/disable|enable - •История доставок с курсорной пагинацией:
GET /me/webhooks/{id}/deliveries - •Ручной retry:
POST /me/webhooks/{id}/deliveries/{did}/retry - •Тестовая отправка из дашборда:
POST /me/webhooks/{id}/test - •Подписанный test-event с тем же HMAC-форматом
Wave 3: API v2 и payment links
- •Все v2-эндпоинты:
POST /v2/qr,/v2/invoices,/v2/refunds,GET /v2/payments,GET /v2/events - •Mandatory
Idempotency-Keyна мутирующих POST - •Cursor-based pagination (
?cursor=&limit=&has_more) - •Унифицированный формат ошибок:
{error: {type, code, message, request_id, param, category}} - •Платёжные ссылки:
POST /v2/payment-linksс success_url, cancel_url, allow_repeat, email_required, metadata - •Hosted Checkout:
https://paybot.kz/checkout/{token}с автодетектом mobile / desktop - •Embed-виджет: