Оплата прошла, а заказ в Shop-Script не оплачен: как проверить callback и статус

Покупатель видит подтверждение платежа, а менеджер открывает заказ в Shop-Script и обнаруживает, что он всё ещё ожидает оплаты. При этом повторное нажатие кнопки оплаты может создать ещё одну транзакцию. Разбираться нужно не с видимой кнопки, а со связью между операцией в платёжной системе и обработкой её результата магазином.

Ниже — порядок диагностики без повторного списания денег и без произвольного изменения статусов. Он подходит для разных платёжных плагинов Webasyst, но названия статусов, интерфейсы и правила уведомлений необходимо сверять с документацией конкретного провайдера.

Зафиксируйте один проблемный заказ и его транзакцию

Запишите внутренний идентификатор заказа, отображаемый покупателю номер, дату и время, платёжный метод, ожидаемую сумму и валюту. В кабинете провайдера найдите операцию по безопасному идентификатору транзакции, а не только по имени или сумме: у нескольких заказов могут совпасть значения. Проверьте также, не было ли повторных попыток оплаты.

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

Отделите авторизацию платежа от фактического списания

Надпись «успешно» на странице возврата не всегда означает окончательно полученные деньги. У провайдера могут различаться авторизация суммы, подтверждённое списание, отмена, возврат и отклонённая операция. Посмотрите конечное финансовое состояние именно в кабинете платежной системы и, при необходимости, в отчёте сверки.

Если деньги только авторизованы, не выполняйте повторное списание вручную, пока не выяснены настройки capture и поддерживаемый сценарий провайдера. Если операция уже списана, не просите покупателя оплатить ещё раз. Если операция отклонена, нельзя помечать заказ оплаченным только потому, что покупатель видел экран завершения.

Проверьте историю действий заказа в Shop-Script

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

Не путайте финансовый результат и отображаемое название статуса. В магазине могли изменить поток обработки, добавить собственные действия или подключить плагин, который влияет на переходы. Поэтому проверьте факт регистрации транзакции и правила перехода отдельно. Ручная смена статуса без сверки с провайдером маскирует причину сбоя.

Разделите возврат покупателя и серверное уведомление

После оплаты покупатель может вернуться по адресу успеха, но серверное подтверждение платежа обрабатывается другим механизмом. Webasyst предусматривает обратные запросы (callback) для платёжных плагинов. В документации по плагинам оплаты описаны обработчики callback и передача результата приложению. Наличие страницы «Спасибо за заказ» само по себе не доказывает, что этот обработчик завершился успешно.

Проверьте, какой именно адрес уведомления указал установленный платёжный плагин, и сопоставьте его с настройками кабинета провайдера. Не копируйте универсальный URL из чужой инструкции: путь и параметры зависят от используемого плагина и конфигурации сайта.

Убедитесь, что уведомление действительно дошло до сервера

Сверьте время запроса в журнале провайдера с журналом веб-сервера и приложения. Изучите HTTP-ответ, возможные перенаправления между HTTP и HTTPS, ограничения брандмауэра, защиту от ботов, блокировки IP и ошибки PHP. Callback может не доходить после смены домена, сертификата, маршрута или правил безопасности.

Даже код HTTP 200 ещё не гарантирует корректное изменение заказа: обработчик мог вернуть страницу без регистрации нужного события. Если провайдер сообщает об ошибке доставки, сначала исправьте причину и используйте предусмотренный им безопасный механизм повторного уведомления. Не отправляйте искусственный «успешный callback»: Webasyst требует проверять подлинность полученных данных, включая подпись или контрольную сумму.

Сопоставьте журнал плагина с ответом платёжной системы

Ищите один и тот же идентификатор транзакции, номер заказа, время и тип операции на трёх уровнях: провайдер, веб-сервер и платёжный плагин. Возможны разные сценарии: запрос не приходил, был заблокирован, не прошёл проверку подписи, не нашёл заказ или не смог выполнить действие в потоке Shop-Script.

Если ошибка возникла после обновления, зафиксируйте версии ядра Webasyst, Shop-Script, плагина оплаты и PHP, а также время внесённых изменений. Не включайте подробное логирование секретов на рабочем магазине. Для поиска конфликтов обработчиков и безопасного исправления логики можно использовать доработку и программирование Shop-Script с тестами по нескольким состояниям платежа.

Проверьте сопоставление магазина, валюты и идентификаторов

При нескольких витринах или нескольких аккаунтах мерчанта возможна ситуация, когда оплата прошла в одном кабинете, а уведомление направлено другой конфигурации. Сверьте идентификатор магазина у провайдера, настройки способа оплаты, валюту, сумму и внутренний номер заказа. Различайте публичный номер и технический ID: форматы могут отличаться.

Проверьте, что сервер корректно обрабатывает уже полученное уведомление: повторная доставка одного события не должна создавать второй платёж или менять оплаченный заказ на неверное состояние. Это свойство необходимо проверять на конкретном плагине; наличие универсальной защиты от дублей предполагать нельзя.

Проведите контрольный тест без риска двойной оплаты

В идеале используйте тестовую среду и официальный sandbox платёжной системы, если он предусмотрен. Проверьте четыре исхода: подтверждённая оплата, отмена покупателем, отклонение операции и повторное уведомление по уже обработанной транзакции. Зафиксируйте ожидаемое действие, ответ обработчика, итоговую запись о транзакции и историю заказа.

Если sandbox отсутствует, согласуйте ограниченный тест с ответственным за платежи. Нельзя без необходимости создавать реальные списания, особенно на заказах клиентов. После исправления дополнительно проверьте, что уведомления покупателю, резервирование товаров и сценарий оформления заказа не выполняются повторно.

Как восстановить корректность уже оплаченного заказа

Сначала финансово сверяйте операцию с провайдером. Если деньги действительно получены, зафиксируйте, почему событие не было отражено в Shop-Script, и выберите поддерживаемый механизм корректной регистрации платежа. Согласуйте действие с бухгалтерией и сотрудником, отвечающим за платежи. Не повторяйте capture и не меняйте статус массово без анализа каждого случая.

Сохраните результат в кратком отчёте: заказ, транзакция, подтверждённая сумма, причина, исправление, итоговый статус и проверка повторной обработки. Регулярная сверка платежей, журналов и заказов может входить в техническую поддержку магазина; примеры направлений технических работ размещены в портфолио доработок.

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