Barzahlen / viacash для WooCommerce — оплата готівкою в касі магазину

Barzahlen / viacash for WooCommerce додає у WooCommerce оплату готівкою в касі: покупець оформлює замовлення, отримує від viacash платіжний слип зі штрихкодом і сплачує його на касі партнерського магазину, наприклад супермаркету чи дрогері. Коли viafintech повідомляє, що слип оплачений, замовлення переходить у «В обробці». Модуль працює з вашим власним акаунтом viafintech (ID підрозділу та ключ API), на класичній і блоковій касі, сумісний з HPOS; інтерфейс англійською й німецькою для ринків DE, AT і CH.

Що робить безкоштовна версія

Налаштування лежать в одному місці: WooCommerce → Barzahlen. Вкажіть ID підрозділу (division) і ключ API з додатка viafintech, оберіть тестове середовище viafintech або бойовий режим і натисніть «Check connection»: підписаний запит до viafintech покаже, чи прийняв він ключ. Ключ API зберігається зашифрованим і назад у форму не виводиться. На кожне замовлення створюється один слип: сума замовлення, номер замовлення як референс і строк дії від 1 до 30 днів (за замовчуванням 7). Повторне оформлення того самого замовлення дає той самий слип, запит, що завис через таймаут, повторюється з тим самим ключем ідемпотентності, тож двох слипів не буде; змінилася сума — старий слип анулюється і створюється новий. Після оформлення замовлення чекає на оплату («На утриманні»), а на сторінці «Дякуємо» та в «Мій акаунт → Замовлення» відкривається overlay viacash: слип у PDF, найближчі магазини, відправка слипа на телефон; кнопка відкриває його знову. Якщо адреса виставлення рахунку повна, покупець бачить три найближчі партнерські магазини. Вебхук viafintech перевіряється за підписом BZ1-HMAC-SHA256: оплачений слип переводить замовлення в «В обробці», а якщо сплачена сума відрізняється від суми замовлення — на утримання з поясненням; слип, що сплив або анульований, скасовує замовлення і повертає товар на склад; відхилений слип ставить статус «Не вдалося»; повторні вебхуки нічого не змінюють. Адреса вебхука надсилається разом із кожним слипом (на сайті з https), інакше її вписують у додатку viafintech. Кнопка «Check the status with viafintech» у замовленні питає viafintech про слип, якщо вебхук не прийшов. Ідентифікатор покупця для viafintech — email або номер клієнта магазину. Валюти: EUR, CHF, BGN, CZK, HUF, PLN, RON, SEK, GBP, залежно від вашого договору.

Що додає Pro

Повернення коштів з WooCommerce як слип повернення, повне й часткове; сума повернень не може перевищити сплачену, а viafintech повідомляє, коли покупець забрав гроші в касі. Нагадування: за задану кількість годин до закінчення слипа viacash надсилає його покупцю знову. Скасування замовлення у WooCommerce анулює відкритий слип. Щогодинна перевірка відкритих слипів, про які немає звісток 6 годин (на випадок пропущеного вебхука), і кнопка «Re-check all open slips now». Журнал останніх 200 вебхуків з результатом по кожному. Слип по SMS на телефон з адреси виставлення (міжнародний формат із країни); у замовленні кнопки «надіслати слип повторно e-mail / SMS», «анулювати слип» і «створити новий слип». Обмеження показу методу: сума від і до, країни виставлення, групи клієнтів (зокрема гості); працює на класичній і блоковій касі. Німецький переклад інтерфейсу, ліцензія з 7-денним пробним періодом і оновлення з адмінки.

Що варто знати заздалегідь

• Потрібен ваш акаунт viafintech: ID підрозділу й ключ API беруть у додатку viafintech (Settings / Divisions). Тестове середовище доступне одразу після реєстрації, для бойових платежів потрібен договір із viafintech. Модуль реєстрацію не виконує.
• Вебхук «оплачено» приходить після періоду очікування магазину, тобто через кілька хвилин після оплати на касі; до цього замовлення стоїть «На утриманні».
• Сайт без https: viafintech не викликає адреси http, тож статус оновлюється кнопкою «Check the status» (Free) або щогодинною перевіркою (Pro); на екрані налаштувань є червоне попередження.
• Який ідентифікатор покупця очікує ваш договір, email чи номер клієнта, задається в налаштуваннях; хибний вибір дає помилки з боку API.
• Ліміти viafintech на суму та кількість слипів для покупця діють на їхньому боці: якщо замовлення їх перевищує, покупець бачить «оплата готівкою в магазині неможлива, оберіть інший спосіб», а в замовленні лишається нотатка з причиною.
• Скрипт overlay viacash завантажується з cdn.viafintech.com: так вимагає viafintech.
• Модуль незалежний, не є офіційним плагіном viafintech і не повʼязаний із нею.

Як це працює, крок за кроком

1. У додатку viafintech візьміть ID підрозділу й ключ API (Settings / Divisions).
2. У WooCommerce → Barzahlen введіть їх, залиште тестове середовище й натисніть «Check connection», потім збережіть.
3. Увімкніть «Barzahlen / viacash» у WooCommerce → Налаштування → Оплата; на сайті з https адреса вебхука йде разом із кожним слипом.
4. Покупець оформлює замовлення, отримує слип і сплачує його на касі; замовлення переходить у «В обробці» за вебхуком.

Під капотом

• Запити до API v2 підписуються ключем API (HMAC-SHA256), сам ключ не передається.
• Створення слипа іде з заголовком Idempotency-Key, повтор після таймауту дає той самий слип.
• Вебхук перевіряється за підписом і заголовком Date; слип іншого магазину ігнорується, повтори не дублюють нотаток.
• Ключ API зберігається зашифрованим; сумісно з HPOS і блоковою касою; мови: English, Deutsch (de_DE, de_AT, de_CH).

Як встановити

1. Плагіни → Додати новий → Завантажити плагін: оберіть zip і активуйте.
2. WooCommerce → Barzahlen: ID підрозділу, ключ API, «Check connection».
3. За потреби впишіть адресу вебхука з екрана налаштувань у додатку viafintech (Notification URL).
4. Увімкніть метод оплати «Barzahlen / viacash».

Модуля ще немає на wordpress.org: безкоштовна версія і Pro — один архів з цієї сторінки. Без ключа він працює як безкоштовна версія.