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 — один архив с этой страницы. Без ключа он работает как бесплатная версия.