Обновления без простоя и повтор при сбое сети: как сервис приёма Kaspi-платежей закрывал слабые места
В Казахстане работает несколько независимых сервисов, которые подключают оплату через Kaspi к сайтам, Telegram-ботам и автоматам.

Устроены они одинаково: предприниматель добавляет в свой бизнес-аккаунт Kaspi Pay отдельного сотрудника с ролью «Кассир», а сервис от его имени выставляет счета и следит за оплатой. Деньги идут напрямую на счёт продавца, сервис их не держит. Главная задача такого посредника — вовремя сообщить сайту, что оплата прошла. Если сообщение теряется, деньги на счету, а покупатель не получает товар.
Qut Pay — один из таких сервисов. 15–16 ноября его разработчики выпустили серию изменений, которые интересны не столько новыми функциями, сколько инженерными решениями.
Повод: тихо потерянные уведомления
Началось с обращения продавца онлайн-курсов: покупатели оплачивали, но не получали ссылку на курс. Платежи были в Kaspi и в Qut Pay отмечены как оплаченные. Причина оказалась в связке ключей: продавец выпустил новый API-ключ и отозвал старый, а адрес уведомлений (webhook) остался привязан к старому. Система считала, что счета нового ключа «не относятся» к этому адресу, и не отправляла их. Ни ошибки, ни предупреждения.
Уведомления о четырёх платежах отправили повторно, все дошли. В коде отзыв ключа теперь отвязывает от него webhook, а кабинет предупреждает, если адрес привязан к отозванному ключу или не получает последние оплаты. После этого команда провела полный аудит платформы.
Аудит: 32 пункта за один день
Аудит шёл по трём направлениям: граница между тестовым и боевым режимами, поиск и доставка оплаты, честность того, что показывает кабинет. Найдено 32 проблемы, каждая закрыта и закреплена автотестом. Некоторые из них:
Тестовый ключ мог создавать боевой счёт и наоборот. Теперь ключ привязан к режиму, и сервер отвечает ошибкой 409 keymodemismatch. Сводка в кабинете складывала боевую выручку с тестовыми платежами, и у одного продавца сумма выглядела вдвое больше. Теперь считается только текущий режим. Если сайт отвечал ошибкой 4xx, уведомление больше не повторялось. Теперь повторяется, а после нескольких неудач подряд продавец получает сообщение в Telegram. Оплату, пришедшую во время разрыва связи с Kaspi, система перепроверяет, когда кассир снова входит в систему. Оговорка: аудит внутренний. Его проводила сама команда, внешний эксперт результаты не проверял.
Обновление без простоя
Раньше при каждом обновлении сервис несколько секунд не отвечал. Для платёжной страницы это заметно: покупатель в эти секунды видит ошибку.
Решение классическое. На сервере теперь работают два экземпляра API: основной и резервный. Резервный обслуживает только HTTP-запросы. Фоновые задачи (опрос статусов в Kaspi, уведомления, Telegram-бот) работают только в основном, иначе каждый счёт проверялся бы и каждое уведомление отправлялось бы дважды. Nginx направляет трафик на основной экземпляр и переключается на резервный, пока основной перезапускается. Скрипт обновления перезапускает их по очереди и ждёт ответа /health от каждого.
Первая проверка выявила тонкость. После перезапуска основной экземпляр ещё 2 секунды считается «упавшим» (параметр nginx fail_timeout). Если в эти секунды перезапустить и резервный, nginx некуда отправлять запросы, и он возвращает 502. Во время тестового обновления так случилось дважды. После добавления паузы между перезапусками разработчики провели три обновления подряд и всё это время опрашивали сайт и кабинет: 208 запросов, все с ответом 200.
Есть и ограничение: изменения базы данных должны только добавлять. Несколько секунд резервный экземпляр со старым кодом работает с уже обновлённой схемой, поэтому удалять или переименовывать столбцы в одном обновлении нельзя.
Повтор при сбое сети и почему не всегда
Утром 16 ноября исходящая сеть сервера пропала примерно на три минуты, и за это время три счёта не создались. Очевидный ответ — повторять запрос. Но у счёта на номер телефона есть подвох: Kaspi отправляет счёт клиенту ещё до того, как отвечает. Если ответ не пришёл, счёт мог уже оказаться в приложении покупателя, и повтор пришлёт ему второй.
Поэтому повтор (один, через 1,5 секунды) устроен по-разному:
- QR-счёт повторяется при любой сетевой ошибке. Лишний QR, который никто не отсканировал, просто истечёт.
- Счёт на телефон повторяется, только если соединение не открылось вовсе: DNS не ответил, соединение отклонено, истёк тайм-аут подключения. В этих случаях Kaspi запрос не видел. Если же запрос ушёл, а ответа нет, повтора не будет: счёт помечается как неподтверждённый, а продавец получает сообщение с просьбой проверить его в Kaspi Pay.
Это не спасёт от длительного сбоя, но короткие обрывы, по оценке разработчиков, теперь не должны стоить продавцу продажи.
Чего это не решает
Все эти меры касаются собственной надёжности сервиса. Главный риск всей категории остаётся. Работа через роль «Кассир» — не официальный API Kaspi. Kaspi ограничивает доступ третьих лиц к Kaspi Pay и может прекратить такой доступ. Это касается всех сервисов, работающих по этой схеме, а не только Qut Pay. Сам сервис пишет об этом риске в своём центре доверия и не называет себя партнёром Kaspi.
Тем, кто выбирает такой сервис, стоит проверить две вещи: доходят ли уведомления об оплате до сайта на самом деле (журнал доставки должен быть виден в кабинете) и есть ли запасной способ принять оплату, если доступ к Kaspi прервётся.
История изменений сервиса: api.qut.kz/changelog.