Barzus: як підключити платіжний шлюз до вашого сайту та уникнути втрати замовлень

Кожен власник бізнесу знає цей біль: клієнт додав товари в кошик, заповнив усі поля, натиснув «Оплатити»… а далі сайт завис, викинув помилку або просто не підтвердив транзакцію. У вас — втрачена покупка, у клієнта — зіпсований настрій. І це не просто неприємність. Дослідження свідчать, що до 70% онлайн-покупців залишають сайт після невдалої спроби оплати. Якщо ваш платіжний шлюз працює нестабільно або підключений неправильно, ви можете втрачати десятки тисяч гривень щомісяця.

Сьогодні ми розберемо покрокову інструкцію, як підключити платіжний шлюз до вашого сайту та уникнути втрати замовлень. У центрі уваги — популярний сервіс Barzus, який вже зарекомендував себе як надійного партнера для українських магазинів. Якщо ви користуєтеся WordPress, WooCommerce, OpenCart або стандартними SaaS-рішеннями — ця інструкція для вас.

Чому платіжний шлюз «втрачає» гроші

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

Ось три головні причини, чому замовлення «втрачаються» через платіжний шлюз:

1. Неправильний API-ключ або секретний ключ — найдрібніша помилка в одній літері блокує всі платежі.
2. Застарілий плагін або модуль — версія плагіна не сумісна з новими протоколами безпеки Barzus.
3. Невірний URL для сповіщень (вебхук) — сайт не отримує сигнал про успішну оплату, тому замовлення залишається в статусі «очікує».

Згідно з внутрішньою статистикою Barzus, до 35% технічних звернень від магазинів пов’язані саме з підключенням, а не з роботою самого шлюзу. І найсумніше: більшість цих проблем вирішуються за 10-15 хвилин самостійно.

Як підключити Barzus до вашого сайту: покрокова інструкція

Якщо ви використовуєте WordPress + WooCommerce — це найпоширеніший варіант, тому я розпишу кроки саме для нього. Для власників інших систем — OpenCart, власних рішень — після цього блоку буде окремий розділ із загальними принципами.

Крок 1. Отримайте API-ключі в кабінеті Barzus

1. Зайдіть в особистий кабінет Barzus (барзус.юа або за вашим доменом).
2. Перейдіть у розділ «Налаштування» → «Технічні налаштування».
3. Скопіюйте «ID мерчанта» (Merchant ID) та «Секретний ключ» (Secret Key). Не плутайте з іншими полями — саме ці два знадобляться.
4. Збережіть ключі в безпечному місці, наприклад, у зашифрованому файлі або менеджері паролів.

⚠️ Важливо: ніколи не показуйте секретний ключ публічно — він дає доступ до всіх фінансових операцій вашого магазину.

Крок 2. Встановіть і налаштуйте плагін Barzus

1. У адмін-панелі WordPress перейдіть: Плагіни → Додати новий.
2. У полі пошуку введіть «Barzus for WooCommerce» (офіційна назва). Встановіть та активуйте плагін.
3. Перейдіть: WooCommerce → Налаштування → Платіжні шлюзи.
4. Знайдіть рядок «Barzus» (або «Barzus Payment Gateway»). Натисніть «Налаштувати/Manage».
5. Вставте скопійовані раніше ID мерчанта та Секретний ключ у відповідні поля.
6. Обов'язково встановіть «Режим роботи» на «Тестовий» (Sandbox/Test), якщо хочете перевірити, або на «Живий» (Live) для реальних платежів.
7. Збережіть зміни.

Крок 3. Налаштуйте вебхук (сповіщення про оплату)

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

1. У тій самій сторінці налаштувань плагіна знайдіть поле «URL сповіщень» або «Callback URL».
2. Скопіюйте URL, який там автоматично згенеровано (зазвичай він виглядає як https://вашсайт.юа/wc-api/barzus_payment_callback).
3. Увійдіть в особистий кабінет Barzus. Перейдіть: Налаштування → Технічні налаштування → Вебхуки.
4. Додайте новий вебхук, вставте скопійований URL. Виберіть подію «Оплата успішна» (payment.success).
5. Збережіть.

Крок 4. Зробіть тестову покупку

Тепер — найприємніша частина. Купіть якийсь недорогий товар у себе на сайті (наприклад, за 1 гривню) за допомогою тестової карти. Barzus надає тестові картки в документації, але найпростіше — скористатися карткою з номером 4242 4242 4242 4242, будь-якими датами та CVV.

Перевірте:

• Чи з'явилося замовлення в WooCommerce зі статусом «Виконано» (Completed) або «Обробка» (Processing)?
• Чи прийшло сповіщення до вас (емейл, СМС)?
• Чи відобразилася сума в кабінеті Barzus?

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

Що робити, якщо у вас не WooCommerce, а інша система

Якщо ваш сайт працює на OpenCart, Joomla, Magento або власному рішенні — конкретні кроки залежать від версії CMS та теми. Проте загальний алгоритм однаковий:

1. Знайдіть офіційний модуль Barzus у маркеті плагінів вашої системи. Якщо немає — використовуйте універсальний метод через API.
2. Введіть ключі (Merchant ID та Secret Key) у налаштування платіжного методу.
3. Налаштуйте Callback URL: у всіх системах це робиться одним і тим самим принципом — вкажіть у налаштуваннях шлюзу Barzus адресу, куди система має надсилати підтвердження оплати. Зазвичай це сторінка https://вашсайт/checkout/return або https://вашсайт/api/barzus_callback.
4. Обов'язково протестуйте: навіть якщо модуль платний, без тесту не запускайте живий режим.

Для саморобних сайтів на PHP/JavaScript даю чесну пораду: тут неможливо дати універсальні пункти меню, бо код у кожного свій. Але суть така: додайте HTTP-запит до API Barzus із передачею даних замовлення, і переконайтеся, що ваш бекенд вміє приймати POST-запити від Barzus на окремий ендпоінт. Найпростіший спосіб для власників бізнесу — попросити свого розробника слідувати документації Barzus (вона безкоштовна та зрозуміла).

Як перевірити, чи все працює правильно, без технічних навичок

Навіть якщо ви не програміст, ви можете швидко діагностувати проблему:

• Запишіть відео процесу оплати на своєму сайті. Потім перегляньте: чи не зникає кнопка «Оплатити»? Чи не з'являються помилки? Це допоможе вам описати проблему фахівцю.
• Перевірте дату останнього оновлення плагіна. Якщо плагін Barzus не оновлювався більше 6 місяців — це червоний прапорець. Ваш сайт може бути вразливим для атак або не сумісним із новими версіями WooCommerce.
• Зробіть замовлення з мінімальною сумою кожні кілька тижнів, щоб переконатися, що шлюз живий.

За статистикою Barzus, магазини, які регулярно проводять такі тест-покупки, втрачають на 45% менше замовлень через технічні збої.

Чому це коштує вашої уваги

Давайте порахуємо реальні гроші. Припустимо, ваш середній чек — 800 грн, а на сайт приходить 100 покупців на день. Якщо кожен десятий (10%) не може оплатити через некоректне підключення Barzus, ви втрачаєте: 800 грн × 10 замовлень = 8 000 грн на добу. За місяць — 240 000 грн. За рік — майже 3 мільйони гривень чистого упущеного прибутку. І це без урахування постійних клієнтів, які більше не повернуться після невдалої оплати.

Час, витрачений на правильне налаштування (30-40 хвилин), окупається сотні разів.

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