Sandbox

Тестовый режим без реальных платежей

Как работает Sandbox

Sandbox позволяет тестировать интеграцию без реальных денег. Все запросы с тестовым ключом возвращают реалистичные ответы, но не затрагивают настоящие счета Kaspi.

Как включить

1. В дашборде переключите тумблер Live → Sandbox в боковом меню

2. Используйте тестовый API ключ kp_test_... вместо kp_live_...

Тестовые ответы

Все эндпоинты в sandbox возвращают формат, идентичный live-режиму:

  • POST /v1/qr/create — создаёт тестовый QR (не работает для реальной оплаты)
  • GET /v1/qr/status/{id} — возвращает статус QrTokenCreated
  • POST /v1/invoice/create — тестовый инвойс
  • POST /v1/history — пустая история
  • Webhooks доставляются на ваш URL с тестовыми данными

Чеклист перед переходом в Live

  • Webhook URL доступен по HTTPS
  • HMAC верификация подписей работает
  • Обработка ошибок (429, 503, 401) реализована
  • Idempotency-Key передаётся на всех POST запросах
  • Refresh token ротация работает корректно