Не проходят оплаты: проблема у вас или у Kaspi?

Вопрос 1. Один счёт или все?

Откройте раздел «Счета» и посмотрите на масштаб.

• Не проходит один конкретный счёт, остальные оплачиваются нормально — проблема почти наверняка локальная: не тот номер покупателя, у покупателя нет приложения Kaspi, истёк срок счёта, закончился дневной лимит тарифа. Это разбирается в статье «Оплата не приходит: проблема у вас».
• Не проходят все или почти все счета сразу — переходите к вопросу 2, это уже похоже на что-то системное.

Вопрос 2. Ошибка в ответе API — или счета создаются, но их не оплачивают?

Это два разных мира.

API отдаёт ошибку при создании счёта. Значит запрос до Kaspi дошёл и получил отказ. У ответа есть error_code — он и есть диагноз: client_not_found (у номера нет Kaspi), organization_not_configured (не настроена организация), trial_daily_limit (упёрлись в дневной лимит тарифа) или ошибка авторизации кассира. По коду ошибки идите в соответствующую статью — это чаще всего «ваша» сторона.

Счета создаются (статус processing или pending), но покупатели не платят или платят с большой задержкой. Тут возможны два варианта. Если покупатель просто ещё не открыл Kaspi — это нормально, счёт живёт 24 часа. Если же многие счета застряли и покупатели жалуются, что у них «не проходит» — переходите к вопросу 3.

Важно про processing: счёт в этом статусе — не «завис». Система сама повторяет попытки (до сотен раз, интервал ≤30 секунд). При высокой нагрузке хвост в processing может законно тянуться даже дольше 60 минут — это ожидаемо, а не поломка. Подробно про статусы — «Жизненный цикл счёта».

Вопрос 3. Открывается ли приложение Kaspi?

Самая простая и честная проверка «жив ли Kaspi прямо сейчас»:

• Откройте приложение Kaspi на своём телефоне. Тормозит, не грузит, показывает ошибки?
• Спросите покупателя (или проверьте сами на тестовом счёте): при оплате Kaspi пишет «Попробуйте позже» или подобное?

Если приложение Kaspi подтормаживает у многих и покупатели видят «Попробуйте позже» — с высокой вероятностью проблема не в вашей настройке, а во временном сбое на стороне приёма. Проверить это косвенно можно так: спросите пару покупателей или коллег — тормозит ли приложение Kaspi у них тоже.

Три исхода — и что делать в каждом

Похоже, проблема у вас

Признаки: не проходит один-два счёта; в ответе есть конкретный error_code; у конкретного покупателя нет приложения Kaspi; истёк тариф или его дневной лимит; недавно перегенерировали ключи. Что делать: разберите по «Оплата не приходит: проблема у вас» — там пошаговый маршрут по симптомам. Отдельно про обрыв сессии кассира — «Почему слетала сессия кассира».

Похоже, сбой на стороне Kaspi

Признаки (по наблюдаемым фактам, без утверждений о внутренностях Kaspi): массовые задержки сразу по многим счетам; покупатели видят «Попробуйте позже»; приложение Kaspi подтормаживает у разных людей; счета подолгу висят в processing. В такие периоды приём временно замедляется — тогда наша система автоматически замедляет очередь выставления (интервал между счетами кассира растёт, чтобы не усугублять нагрузку).

Что в это время делаем МЫ:

• замедляем очередь автоматически, чтобы не усугублять нагрузку;
• не теряем счета — система продолжает повторять попытки и доставит счёт, когда Kaspi оживёт;
• доставим вебхуки и уведомления об оплатах, когда связь восстановится.

Что делать ВАМ:

• подождите — это временно;
• не пересоздавайте счета лавиной. Если запустить массовое пересоздание, вы получите дубли и по несколько «живых» счетов на один заказ. Счёт в processing пересоздавать особенно нельзя;
• предупредите покупателей, что оплата может пройти с задержкой — деньги не потеряются.

Похоже, плановые работы ApiPay

Если мы проводим обновление на своей стороне, мы предупреждаем заранее в WhatsApp — на ваш личный номер. Если такое сообщение приходило, ориентируйтесь на указанное в нём время окончания.

Частые ошибки

• Массовое пересоздание счетов при сбое Kaspi — главный способ наплодить дубли. Ждите, не пересоздавайте.
• Пересоздание счёта в статусе processing — получите два живых счёта на один заказ.
• Считать processing дольше часа поломкой — при нагрузке это законно.
• Винить настройку при массовом сбое — сначала проверьте, открывается ли приложение Kaspi у вас и у покупателей.
• Молчать перед покупателями — короткое «оплата может пройти с задержкой» снимает половину паники.

Вопросы и ответы