Skip to main content
Полный перечень полей — в глоссарии интеграции с Kaspi. Kaspi-оплата (карточка платежа) — приложение к обычной оплате (см. «Оплата: модель, знак и проверки»), хранящее детали платежа через платёжный сервис Kaspi: способ (QR-код или счёт на телефон), идентификатор операции, статус, ссылку на чек и полный ответ сервиса.

​
Оплата через платёжный сервис Kaspi

При создании оплаты с признаком оплаты через Kaspi система обращается к сервису и создаёт карточку Kaspi-оплаты:
1

Выбор способа

Если указан телефон плательщика — выставляется счёт на телефон, иначе создаётся QR-код.
2

Ожидание оплаты

Сама оплата ставится в состояние «ожидает оплаты» (деньги ещё не поступили).
3

Входящее уведомление

Фактический результат приходит позже входящим уведомлением от Kaspi: по идентификатору операции находится карточка, в неё пишется статус, ссылка на чек, телефон плательщика и полный ответ сервиса, а та же самая оплата переводится в «успешно», «ошибка» или «истёк срок» — по типу события.
4

Уведомление сотрудникам

После этого сотрудникам создаётся уведомление о результате. В тексте указано, к чему относится платёж — к аренде, продаже или заказу мастерской (с номером), — чтобы по уведомлению сразу было понятно, куда смотреть.
Уведомление обновляет уже существующую оплату и никогда не создаёт новую. Если карточки Kaspi-оплаты по присланному идентификатору операции нет, событие записывается в лог и игнорируется — приходов «из ниоткуда» не появляется. События неизвестных типов тоже пропускаются без изменений.
Входящее уведомление обрабатывается только при верной подписи запроса. Если секрет подписи не задан, подпись считается неверной и уведомления по сути не принимаются.
Отдельно существует публичная страница оплаты аренды, где клиент сам платит через Kaspi по QR — по прямой ссылке на аренду или найдя её по номеру телефона, без входа в систему. Там оплата создаётся сразу в состоянии «успешно» (ещё до фактического получения денег), сумма ограничена остатком долга по аренде, а сама страница защищена ограничением частоты — повторный запрос по той же ссылке в течение двух минут отклоняется. Подробности — на странице «Публичная страница оплаты аренды».

​
Связанные страницы

Глоссарий: Интеграция с Kaspi

Полный перечень полей Kaspi-оплаты.

Оплата: модель, знак и проверки

Статус «ожидает оплаты» и уведомления о поступлении денег.

Публичная страница оплаты аренды

Ссылка на аренду, поиск по телефону и оплата через Kaspi без входа в систему.