Клиент показывает успешную оплату, деньги видны у платёжного провайдера, но в KeyCRM заказ по-прежнему без платежа. Другой вариант той же проблемы — в CRM появились две строки, и менеджер подозревает двойное списание. В обоих случаях худшее решение — сразу просить покупателя заплатить ещё раз или удалять одну из записей.
Банковская транзакция, передача её результата через интеграцию и создание платежа в заказе KeyCRM — отдельные этапы. Поэтому сверку нужно проводить последовательно: от факта списания до конкретного заказа, суммы, способа оплаты и происхождения каждой записи. Ниже — практический чек-лист, который поможет выполнить такую проверку без риска повторного списания.
Ключевые выводы
- Платёж в банке и запись в KeyCRM — не одно событие. Деньги могут быть уплачены, но передача в CRM может не состояться из-за статуса транзакции, отсутствующего заказа, неоднозначного совпадения или ошибки доступа.
- Не просите покупателя платить повторно до завершения сверки. Отсутствие строки в CRM само по себе не доказывает, что деньги не поступили.
- Две записи в KeyCRM не обязательно означают два банковских списания. Вторую строку мог создать другой модуль, штатная интеграция, менеджер или отдельный автоматизированный процесс.
- Основной ключ сверки — номер заказа Хорошопа. Вместе с ним нужно сравнивать сумму, время, валюту и признак полной или частичной оплаты.
- В CRM передаётся фактически уплаченная сумма. Если покупатель внёс частичную предоплату, платёж в KeyCRM не должен автоматически равняться полной стоимости заказа.
- Не корректируйте данные вручную только из-за расхождения в интерфейсах. Сначала определите, на каком этапе возникла проблема и кто создал каждую запись.
Содержание
- Как проходит платёж от банка до KeyCRM
- Первые действия без риска повторного списания
- Сверка номера, суммы, времени и настроек
- Что делать, если в KeyCRM две записи
- Контрольный тест и подготовка обращения в поддержку
- Частые вопросы
Как проходит платёж от банка до KeyCRM
Три отдельных этапа одной оплаты
Для менеджера оплата часто выглядит как одно действие: покупатель нажал кнопку, деньги списались, заказ должен стать оплаченным. Технически между этими событиями есть несколько переходов:
- Платёжный провайдер обрабатывает транзакцию и фиксирует её результат.
- Информация о платеже передаётся в интеграционный поток LoyalShop.
- Интеграция находит соответствующий заказ и создаёт в нём платёж в KeyCRM.
Успех первого этапа не гарантирует успеха третьего. Например, деньги могут быть получены, но интеграция не найдёт однозначное соответствие заказа по номеру Хорошопа. Другой сценарий — KeyCRM временно не примет запрос из-за проблемы с доступом. Поэтому фраза «в банке оплачено» подтверждает факт на стороне платежа, но ещё не объясняет состояние CRM.
Как интеграция ищет заказ
Запись платежа привязывается к заказу, который интеграция ищет по номеру Хорошопа. Если соответствующего заказа в KeyCRM нет, номер отличается или поиск даёт неоднозначный результат, платёж может быть не записан.
Проверять нужно не только имя или телефон покупателя. Эти данные помогают найти клиента, но не заменяют номер заказа. Один покупатель может оформить несколько заказов подряд, а одинаковые суммы могут случайно совпасть.
Почему статус транзакции имеет значение
Наличие операции в интерфейсе банка или на скриншоте клиента ещё не всегда означает, что платёж получил завершённый статус, подходящий для передачи. Во время сверки нужно открыть транзакцию в кабинете платёжного провайдера и проверить её фактический результат.
Не стоит устанавливать универсальный срок вроде «подождите пять минут». Для этого потока нет подтверждённого гарантированного времени синхронизации. Если данные не появились, проверяйте этапы и настройки, а не рассчитывайте, что дополнительная пауза обязательно устранит проблему.
Первые действия без риска повторного списания
Зафиксируйте исходные данные
До любых изменений соберите минимальный набор данных для сверки. Он должен описывать одну конкретную транзакцию и один конкретный заказ:
- номер заказа Хорошопа;
- идентификатор транзакции у платёжного провайдера;
- фактически уплаченную сумму;
- валюту;
- дату и время платежа;
- признак полной оплаты или частичной предоплаты;
- выбранный покупателем способ оплаты;
- текущий результат платежа у провайдера.
Для условного заказа на 2400 ₴ покупатель мог внести предоплату 300 ₴. В таком случае правильная запись в CRM — 300 ₴, а не 2400 ₴. Разница между суммой заказа и платежа не является ошибкой, если сценарий предусматривал частичную оплату.
Не запускайте повторную оплату
Пока не установлен результат первой транзакции, не отправляйте покупателю новую платёжную кнопку со словами «первая оплата не прошла». Если деньги уже получены, вторая попытка создаст реальный риск повторного списания, а не просто дубль в CRM.
Безопасное сообщение клиенту может выглядеть так: «Мы сверяем платёж по вашему заказу. Повторно оплачивать его пока не нужно». Оно не обещает конкретного срока, но защищает покупателя от лишней операции.
Не удаляйте строку в CRM до проверки
Если записей две, сначала выясните происхождение каждой. Удаление одной строки без проверки может скрыть важное отличие: другое время, сумму, метод или источник создания. Кроме того, операция в CRM и списание в банке — разные сущности. Удаление строки не отменяет банковский платёж.
До завершения проверки можно внутренне отметить заказ для менеджеров, чтобы его не передавали на повторное взыскание. Конкретный способ такой отметки зависит от процессов магазина.
Сверка номера, суммы, времени и настроек
Сравните данные в трёх точках
Удобно создать простую рабочую таблицу вне CRM или запись во внутренней задаче. Для каждого поля укажите значение у платёжного провайдера, в заказе Хорошопа и в KeyCRM. Как минимум сравните номер, сумму, валюту, время и тип оплаты.
- Номер. Проверьте его символ в символ, не предполагая, что похожий номер относится к тому же заказу.
- Сумма. Сравнивайте фактическую оплату, а не только полную стоимость корзины.
- Время. Оно помогает отличить две попытки оплаты или ручную запись менеджера.
- Валюта. Одинаковое число в разных валютах не является одинаковым платежом.
- Полная или частичная оплата. Этот признак объясняет, почему сумма платежа меньше суммы заказа.
Если проблема возникает только на мобильных устройствах или на отдельном шаге оформления, дополнительно пройдите чек-лист мобильного checkout от рекламы до оплаты. Это поможет отделить проблему самой оплаты от ошибки отображения или сценария оформления.
Проверьте запись платежей в CRM
В конфигурации нужно проверить, включена ли запись платежей в KeyCRM и правильно ли сопоставлены способы оплаты. Настройки CRM отвечают за передачу и соответствие методов, но не являются универсальным переключателем видимости платёжной кнопки.
При этом штатная оплата магазина и платёжный виджет LoyalShop могут быть разными потоками. Если менеджер проверяет настройки не того механизма, он может видеть корректные ключи, но не те, через которые была проведена конкретная транзакция. Обзор доступных возможностей стоит начинать со страницы модулей платформы, а затем сверять фактический сценарий магазина.
Учтите городские правила и методы оплаты
Если магазин использует маршрутизацию Monobank по городу, правило может влиять не только на выбор подключения, но и на параметры записи в CRM. Для полной и частичной оплаты могут использоваться отдельные методы, а запись в CRM в конкретном правиле может быть отключена.
Проверяйте фактический текст города из тестового или проблемного заказа. Маршрутизация работает по текстовому сопоставлению, а не как географический справочник. Если правило не совпало, применяется общая конфигурация. Если же в правиле нет настроенного токена, оно не маршрутизирует платёж через ожидаемое подключение.
Практический тест должен охватывать как минимум три варианта: город, для которого создано правило; населённый пункт той же области; другой регион. Так можно увидеть, относится ли проблема ко всем оплатам или только к конкретной ветке маршрутизации.
Что делать, если в KeyCRM две записи
Сначала проверьте банк, а не количество строк
Две строки в KeyCRM не доказывают наличие двух списаний. Начните с платёжного провайдера: сколько завершённых транзакций связано с этим заказом, какие у них идентификаторы, суммы и время.
Возможны как минимум три условные ситуации:
- одна банковская транзакция и две записи в CRM — вероятно, записи созданы разными источниками;
- две завершённые транзакции и две записи — нужно отдельно разбирать причину повторной оплаты;
- две попытки, но завершена только одна — количество попыток не следует приравнивать к количеству полученных платежей.
Защита от повторной записи в интеграции есть, но она не гарантирует отсутствия любых дублей, созданных другими интеграциями или вручную.
Установите происхождение каждой строки
Для двух записей выпишите их суммы, время, метод и доступный источник создания. Затем выясните, какие системы имеют право записывать платежи в заказ: LoyalShop, другая интеграция, штатный модуль или менеджер.
Условный пример: у провайдера есть одна транзакция на 500 ₴ в 14:05. В KeyCRM видны два платежа на 500 ₴ — в 14:05 и 14:11. Если вторую запись создал менеджер после сообщения клиента, это дубль учётной записи, но не второе списание. Если источник не виден, не делайте вывод только по близкому времени.
Не смешивайте платёж со сменой этапа
Запись платежа в заказе не равнозначна смене его этапа. Интеграционный поток LoyalShop записывает платёж в KeyCRM, но не задаёт новый status_id заказа. Поэтому ситуация «платёж есть, а заказ не перешёл дальше» требует отдельной проверки автоматизации CRM.
Не стоит создавать ещё один платёж только для того, чтобы принудительно запустить правило. Сначала проверьте фактическую запись, источник заказа, текущий этап и доступный в CRM журнал выполнения автоматизации. Универсальная реакция всех триггеров KeyCRM на API-платежи не подтверждена, поэтому конкретный сценарий следует проверять на контрольном заказе.
Контрольный тест и подготовка обращения в поддержку
Воспроизведите тот же маршрут
Контрольный заказ должен повторять условия проблемного: тот же способ оплаты, аналогичный тип полной или частичной оплаты, тот же сценарий городского правила и тот же источник оформления. Иначе успешный тест не опровергнет проблему в отдельной ветке.
- Создайте контрольный заказ и зафиксируйте его номер.
- Пройдите оформление до страницы, на которой в вашей интеграции появляется платёжное действие.
- Выполните предусмотренную тестом оплату, не передавая секретные ключи посторонним лицам.
- Проверьте результат у платёжного провайдера.
- Сверьте сумму и запись в том же заказе KeyCRM.
- Если ожидается автоматизация CRM, отдельно проверьте её журнал и результат.
Не используйте контрольный тест как способ повторно оплатить реальный клиентский заказ. Его цель — воспроизвести маршрут на отдельном заказе с известными условиями.
Подготовьте безопасный пакет данных
Если самостоятельная сверка не показала причину, подготовьте для поддержки номер заказа, идентификатор транзакции, дату и время, сумму, валюту, тип полной или частичной оплаты и скриншот результата без платёжных реквизитов.
Не отправляйте в письмах или на скриншотах секретные ключи, токены, полные данные карты или другие реквизиты, которые не нужны для идентификации операции. Для проверки обычно важны идентификаторы и параметры события, а не секреты доступа.
Когда обращаться в KeyCRM
Если платёж уже корректно записан, но правило CRM не сработало, обращение должно описывать именно автоматизацию: желаемое событие, условия отбора, ожидаемое действие, номер заказа и конкретное правило. Не подменяйте событие условием «заказ уже оплачен» — это разные части логики.
Если же записи нет, сначала локализуйте проблему между платёжным провайдером, поиском заказа и передачей в KeyCRM. Такое разделение сокращает количество предположений и позволяет поддержке проверять конкретный этап, не предлагая покупателю опасную повторную оплату.
