Клієнт показує успішну оплату, гроші видно у платіжного провайдера, але в KeyCRM замовлення досі без платежу. Інший варіант тієї самої проблеми — у CRM з’явилися два рядки, і менеджер підозрює подвійне списання. В обох випадках найгірше рішення — одразу просити покупця заплатити ще раз або видаляти один із записів.

Банківська транзакція, передача її результату через інтеграцію та створення платежу на замовленні KeyCRM — окремі етапи. Тому звірка має йти послідовно: від факту списання до конкретного замовлення, суми, способу оплати та походження кожного запису. Нижче — практичний чекліст, який допоможе провести таку перевірку без ризику повторного списання.

Ключові висновки

  • Платіж у банку та запис у KeyCRM — не одна подія. Гроші можуть бути сплачені, але передача в CRM не відбутися через статус транзакції, відсутнє замовлення, неоднозначний збіг або помилку доступу.
  • Не просіть покупця платити повторно до завершення звірки. Відсутність рядка в CRM сама по собі не доводить, що гроші не надійшли.
  • Два записи в KeyCRM не обов’язково означають два банківські списання. Другий рядок міг створити інший модуль, штатна інтеграція, менеджер або окремий автоматизований процес.
  • Основний ключ звірки — номер замовлення Хорошопу. Разом із ним потрібно порівнювати суму, час, валюту та ознаку повної або часткової оплати.
  • У CRM передається фактично сплачена сума. Якщо покупець зробив часткову передоплату, платіж у KeyCRM не повинен автоматично дорівнювати повній вартості замовлення.
  • Не встановлюйте баланс вручну лише через розбіжність інтерфейсів. Спочатку визначте, на якому етапі виникла проблема і хто створив кожен запис.
Оплата в банку є, а в KeyCRM її немає або записів два: чекліст звірки без повторного списання

Зміст

Як проходить платіж від банку до KeyCRM

Три окремі етапи однієї оплати

Для менеджера оплата часто виглядає як одна дія: покупець натиснув кнопку, гроші списалися, замовлення має стати оплаченим. Технічно між цими подіями є кілька переходів:

  1. Платіжний провайдер обробляє транзакцію та фіксує її результат.
  2. Інформація про платіж передається до інтеграційного потоку LoyalShop.
  3. Інтеграція знаходить відповідне замовлення та створює на ньому платіж у KeyCRM.

Успіх першого етапу не гарантує успіху третього. Наприклад, гроші можуть бути отримані, але інтеграція не знайде однозначне замовлення за номером Хорошопу. Інший сценарій — KeyCRM тимчасово не прийме запит через проблему доступу. Тому фраза «у банку оплачено» підтверджує факт на стороні платежу, але ще не пояснює стан CRM.

Як інтеграція шукає замовлення

Запис платежу прив’язується до замовлення, яке інтеграція шукає за номером Хорошопу. Якщо відповідного замовлення в KeyCRM немає, номер відрізняється або пошук дає неоднозначний результат, платіж може не бути записаний.

Перевіряти потрібно не лише ім’я чи телефон покупця. Ці дані допомагають знайти клієнта, але не замінюють номера замовлення. Один покупець може оформити кілька замовлень поспіль, а однакові суми можуть випадково збігатися.

Чому статус транзакції має значення

Наявність операції в інтерфейсі банку або на скриншоті клієнта ще не завжди означає, що платіж отримав завершений статус, придатний для передачі. Під час звірки потрібно відкрити транзакцію в кабінеті платіжного провайдера та перевірити її фактичний результат.

Не варто встановлювати універсальний строк на кшталт «зачекайте п’ять хвилин». Для цього потоку немає підтвердженого гарантованого часу синхронізації. Якщо дані не з’явилися, перевіряйте етапи та налаштування, а не розраховуйте, що додаткова пауза обов’язково усуне проблему.

Перші дії без ризику повторного списання

Зафіксуйте вихідні дані

До будь-яких змін зберіть мінімальний набір для звірки. Він має описувати одну конкретну транзакцію та одне конкретне замовлення:

  • номер замовлення Хорошопу;
  • ідентифікатор транзакції у платіжного провайдера;
  • фактично сплачену суму;
  • валюту;
  • дату й час платежу;
  • ознаку повної оплати або часткової передоплати;
  • вибраний покупцем спосіб оплати;
  • поточний результат платежу у провайдера.

Для умовного замовлення на 2400 грн покупець міг внести 300 грн передоплати. У такому разі правильний запис у CRM — 300 грн, а не 2400 грн. Різниця між сумою замовлення та платежу не є помилкою, якщо сценарій передбачав часткову оплату.

Не запускайте повторну оплату

Поки не встановлено результат першої транзакції, не надсилайте покупцеві нову платіжну кнопку зі словами «перша оплата не пройшла». Якщо гроші вже отримані, друга спроба створить реальний ризик повторного списання, а не просто дубль у CRM.

Безпечне повідомлення клієнтові може бути таким: «Ми звіряємо платіж за вашим замовленням. Повторно оплачувати його поки не потрібно». Воно не обіцяє конкретного строку, але захищає покупця від зайвої операції.

Не видаляйте рядок у CRM до перевірки

Якщо записів два, спочатку з’ясуйте походження кожного. Видалення одного рядка без перевірки може приховати важливу відмінність: різний час, суму, метод або джерело створення. До того ж операція в CRM і списання в банку — різні сутності. Видалення рядка не скасовує банківський платіж.

До завершення перевірки можна внутрішньо позначити замовлення для менеджерів, щоб його не передавали на повторне стягнення. Конкретний спосіб такої позначки залежить від процесів магазину.

Звірка номера, суми, часу та налаштувань

Порівняйте дані в трьох точках

Зручно зробити просту робочу таблицю поза CRM або запис у внутрішній задачі. Для кожного поля зазначте значення у платіжного провайдера, у замовленні Хорошопу та в KeyCRM. Мінімально порівняйте номер, суму, валюту, час і тип оплати.

  1. Номер. Перевірте його символ у символ, без припущення, що схожий номер стосується того самого замовлення.
  2. Сума. Порівнюйте фактичну оплату, а не лише повну вартість кошика.
  3. Час. Він допомагає відрізнити дві спроби оплати або ручний запис менеджера.
  4. Валюта. Однакове число в різних валютах не є однаковим платежем.
  5. Повна чи часткова оплата. Ця ознака пояснює, чому сума платежу менша за суму замовлення.

Якщо проблема виникає лише на мобільних пристроях або на окремому кроці оформлення, додатково пройдіть чекліст мобільного 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-платежі не підтверджена, тому конкретний сценарій слід перевіряти на контрольному замовленні.

Контрольний тест і підготовка звернення в підтримку

Відтворіть той самий маршрут

Контрольне замовлення має повторювати умови проблемного: той самий спосіб оплати, аналогічний тип повної або часткової оплати, той самий сценарій міського правила та те саме джерело оформлення. Інакше успішний тест не спростує проблему в окремій гілці.

  1. Створіть контрольне замовлення та зафіксуйте його номер.
  2. Пройдіть оформлення до сторінки, на якій у вашій інтеграції з’являється платіжна дія.
  3. Виконайте передбачену тестом оплату без передавання секретних ключів стороннім особам.
  4. Перевірте результат у платіжного провайдера.
  5. Звірте суму та запис на тому самому замовленні KeyCRM.
  6. Якщо очікується автоматизація CRM, окремо перевірте її журнал і результат.

Не використовуйте контрольний тест як спосіб повторно оплатити реальне клієнтське замовлення. Його мета — відтворити маршрут на окремому замовленні з відомими умовами.

Підготуйте безпечний пакет даних

Якщо самостійна звірка не показала причину, для підтримки підготуйте номер замовлення, ідентифікатор транзакції, дату й час, суму, валюту, тип повної або часткової оплати та скриншот результату без платіжних реквізитів.

Не надсилайте в листах або скриншотах секретні ключі, токени, повні карткові дані чи інші реквізити, які не потрібні для ідентифікації операції. Для перевірки зазвичай важливі ідентифікатори та параметри події, а не секрети доступу.

Коли звертатися до KeyCRM

Якщо платіж уже коректно записаний, але не спрацювало правило CRM, звернення має описувати саме автоматизацію: бажану подію, умови відбору, очікувану дію, номер замовлення та конкретне правило. Не підмінюйте подію умовою «замовлення вже сплачено» — це різні частини логіки.

Якщо ж запису немає, спочатку локалізуйте проблему між платіжним провайдером, пошуком замовлення та передачею в KeyCRM. Такий поділ скорочує кількість припущень і дозволяє підтримці перевіряти конкретний етап, не пропонуючи покупцеві небезпечну повторну оплату.