Коротко
Если счёт в статусе paid, а денег не видно, причина одна из трёх. Первая и самая частая — режим песочницы: там реальные деньги не двигаются вообще, счёт помечен оплаченным, но транзакции не было. Вторая — деньги ищут не там: у нас они не бывают никогда, они приходят прямо на ваш счёт Kaspi Pay, значит и смотреть надо в приложении Kaspi. Третья — кассир принадлежит другой организации Kaspi: деньги ушли на счёт той организации.
Разделить эти три случая занимает пять минут.
1. Не включён ли тестовый режим
Самый частый случай и самый простой в проверке. Посмотрите на ключ:
| Ключ | Режим | Деньги |
|---|---|---|
qp_test_… | Песочница | Не двигаются. Kaspi вообще не вызывается |
qp_live_… | Боевой | Двигаются, прямо на ваш счёт Kaspi |
В песочнице всё выглядит по-настоящему: счёт создаётся, статус меняется, приходит вебхук, счёт виден в кабинете. Не происходит только одного — движения денег, потому что в Kaspi не ушло ни одного запроса. Оплату в песочнице вы симулируете сами, ни покупатель, ни банк в этом не участвуют.
Поэтому первое, что нужно проверить, — префикс ключа. Если это qp_test_, дальше искать незачем: ответ найден.
При переходе в боевой режим ключ тоже нужно поменять: если переключить режим в кабинете, а ключ оставить прежний, ваша интеграция так и останется в песочнице.
2. Где искать деньги
Это стоит знать точно: деньги никогда не бывают у нас. Qut Pay — инструмент, который выставляет счета через ваш собственный аккаунт Kaspi Pay. Когда покупатель платит, деньги приходят прямо на ваш счёт Kaspi и через нашу систему не проходят.
Значит, смотреть надо в Kaspi Pay, а не в нашем кабинете. Кабинет показывает только статус счёта.
| Куда смотреть | Что увидите |
|---|---|
| Кабинет Qut Pay | Статус счёта: paid, pending, expired |
| Приложение или кабинет Kaspi Pay | Транзакции и остаток на счёте |
Если транзакция в Kaspi Pay есть, а в вашей системе заказ не закрыт, дело в вебхуке, а не в деньгах. Если транзакции нет совсем, переходите к следующему разделу.
Когда и в каком виде приходят деньги, определяет сам Kaspi: ни на эти сроки, ни на условия Kaspi мы повлиять не можем.
3. Кассир принадлежит другой организации
Организация Kaspi фиксируется при первой привязке. Если подключённый кассир — сотрудник в аккаунте Kaspi Pay другого юридического лица (другого ИП или ТОО), деньги придут на счёт той организации, а не на ваш.
Так бывает, в частности, когда:
- Номер кассира взяли у знакомого или бывшего партнёра
- На одного человека оформлено несколько бизнесов и организации перепутались
- Бухгалтер подключил сотрудника второй организации
Проверка: в разделе Kaspi в кабинете посмотрите, какая организация указана на карточке подключения. Совпадает ли она с той, что вы видите в приложении Kaspi Pay? Если нет, подключать нужно кассира правильной организации.
О работе с несколькими кассирами: Можно ли подключить несколько кассиров.
Порядок проверки
- Посмотрите префикс ключа.
qp_test_— песочница, денег не было. Конец. - Откройте Kaspi Pay. Есть ли транзакция? Если есть, деньги на месте, вопрос в учёте на вашей стороне.
- Сверьте сумму и время. Совпадают ли транзакция в Kaspi и счёт в кабинете?
- Проверьте организацию на карточке подключения. Ваша ли это организация?
- Посмотрите полную историю счёта.
GET /api/v1/invoices/{id}отдаёт события и возвраты — не сделан ли возврат?
Если ничего не прояснилось, пройдите общую двухминутную диагностику: Проблема у вас или у Kaspi.
Ещё два случая
Возврат уже сделан. Если счёт в статусе refunded или partially_refunded, деньги вернулись покупателю. Это может сделать и ошибка в коде — проверьте логику возвратов.
Деньги пришли с опозданием. Счёт был закрыт как cancelled или expired, а оплата дошла позже. Тогда событие invoice.paid приходит с меткой late: true: Поздняя оплата.
Чего делать не стоит
- Не просите покупателя заплатить ещё раз, пока не проверили Kaspi Pay. Двойная оплата закончится возвратом и лишней работой.
- Не пересоздавайте счёт. Если деньги уже пришли, второй счёт только запутает учёт.
- Не пишите сразу в поддержку Kaspi. Сначала проверьте режим: подавляющее большинство случаев заканчивается на этом шаге.
Что собрать для поддержки
idсчёта и значениеexternalOrderId- Примерное время оплаты
- Префикс ключа:
qp_test_илиqp_live_ - Есть ли в Kaspi Pay транзакция на эту сумму
- Название организации, указанное в разделе Kaspi в кабинете
Связь: WhatsApp +7 778 881 3333, Telegram @qutpaybot, kazprose@gmail.com.
Вопросы и ответы
Вы удерживаете деньги у себя? Нет. Деньги вообще не проходят через нашу систему и приходят прямо на ваш счёт Kaspi. Процент с транзакции мы тоже не берём — оплата сервиса это месячная подписка.
Превратятся ли счета из песочницы в реальные деньги? Нет. Счета песочницы в боевой режим не переносятся, они существуют только для тестов.
На счёте Kaspi деньги есть, а в кабинете счёт висит в pending. Возможно, обработка задержалась. Подождите немного и перечитайте статус счёта.
Kaspi удерживает свою комиссию? Условия определяет сам Kaspi, и видны они в вашем аккаунте Kaspi Pay. Говорить об этом от имени Kaspi мы не можем.
Можно ли изменить, на какой счёт приходят деньги? Это настройка вашего аккаунта Kaspi Pay, а не наша. Qut Pay счёт зачисления не выбирает. Подробнее: Что такое Qut Pay.