VibeFox Autopay for WooCommerce — Помощь

Требования

WordPress: 6.0 или новее.

WooCommerce: 8.0 или новее, установлен и активен.

PHP: 8.0 или новее.

Сервис Autopay: нужны Service ID и Shared key (хэш-ключ) вашего сервиса Autopay. Они показаны в портале мерчанта Autopay: portal.autopay.eu для рабочей среды и testportal.autopay.eu для тестовой. У тестовых сервисов свои Service ID и Shared key; попросите Autopay открыть такой сервис. Хэш-функция сервиса должна быть SHA-256.

Валюта: валюта магазина должна быть PLN, EUR, GBP, USD или CZK и приниматься вашим сервисом Autopay.

Доступный магазин: Autopay должен иметь возможность отправлять уведомления в ваш магазин, поэтому магазин должен быть доступен из интернета без режима обслуживания, базовой аутентификации и файрвола, который блокирует POST-запросы.

Лицензионный ключ VibeFox: покупается на vibefox.net. Один ключ работает на одном домене.

Установка

1. В WordPress перейдите в Plugins > Add New > Upload Plugin, выберите ZIP-файл плагина и нажмите Install Now. Также можно загрузить папку wcp_autopay_payment в /wp-content/plugins/ по FTP.

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Payments > Autopay > Manage или нажмите Settings под названием плагина на странице Plugins.

4. Введите ваш лицензионный ключ VibeFox в блоке лицензии вверху страницы и нажмите Activate.

5. Введите Service ID и Shared key (тестовой и рабочей среды) и выберите валюты вашего сервиса.

6. В портале Autopay задайте для вашего сервиса URL ITN, адрес возврата и хэш-функцию SHA-256 (см. раздел «Настройка»).

7. Включите Enable/Disable. Оформите тестовый заказ в тестовом режиме, затем снимите отметку Test mode для реальных платежей.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Autopay. Над полями страница предупреждает, если Service ID или Shared key выбранной среды пусты, и если валюта магазина не выбрана в Currencies. В обоих случаях способ оплаты скрывается при оформлении заказа. В списке способов оплаты Autopay помечается как требующий настройки, пока для выбранной среды не заданы учётные данные.

Общие

Enable/Disable: Enable Autopay payment gateway включает или выключает способ оплаты. По умолчанию: выключено.

Title: название способа оплаты, которое видят покупатели при оформлении заказа. По умолчанию: Autopay.

Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay online by bank transfer, BLIK or card. You will be redirected to the secure Autopay payment page.

Сервис Autopay

Service ID и Shared key показаны в портале мерчанта Autopay (portal.autopay.eu или testportal.autopay.eu).

Test mode: Use the Autopay test environment (testpay.autopay.eu) and the test credentials below. По умолчанию: включено. Выключите, чтобы принимать реальные платежи на pay.autopay.eu с рабочими учётными данными.

Service ID (production): числовой идентификатор рабочего сервиса с portal.autopay.eu.

Shared key (production): хэш-ключ рабочего сервиса. Храните его в секрете.

Service ID (test): числовой идентификатор тестового сервиса с testportal.autopay.eu.

Shared key (test): хэш-ключ тестового сервиса.

Currencies: валюты, которые принимает ваш сервис Autopay: PLN, EUR, GBP, USD, CZK. Autopay обычно открывает отдельный сервис для каждой валюты. Способ оплаты предлагается, только если валюта заказа выбрана здесь. По умолчанию: PLN.

Уведомления об оплате (ITN) и адрес возврата

Укажите эти адреса в портале Autopay для вашего сервиса — для рабочей и тестовой среды. Точные адреса показаны в этом разделе настроек.

ITN (transaction notification) URL: https://your-site/?wc-api=wc_ap_payment

Return URL (after payment): https://your-site/?wc-api=wc_ap_return

Без URL ITN заказы никогда не отмечаются оплаченными. Каждое ITN проверяется хэшем SHA-256, созданным с Shared key соответствующего сервиса. Уведомления без действительного хэша или с неизвестным Service ID отклоняются. Уведомление применяется к заказу, только если платёж по этому заказу был начат через тот же сервис Autopay. Уведомления по платежам, начатым до переключения Test mode, по-прежнему проверяются правильным ключом.

Плагин обрабатывает в ITN следующие статусы платежа:

SUCCESS: платёж прошёл; заказ отмечается оплаченным после проверки суммы и валюты.

PENDING: платёж начат; добавляется примечание.

FAILURE: платёж не прошёл; ожидающий заказ переходит в статус Failed.

Дополнительно

Logging: Log payment events записывает в WooCommerce > Status > Logs, источник wcp_autopay_payment. Ключи и данные покупателей никогда не записываются. По умолчанию: выключено.

Оформление заказа

Покупатель выбирает способ оплаты (по умолчанию Autopay) и оформляет заказ. Следующая страница показывает Thank you for your order. You are being redirected to Autopay to complete the payment. и отправляет покупателя на страницу оплаты Autopay. Если покупатель вернулся кнопкой «Назад» в браузере, страница показывает кнопку Pay with Autopay вместо нового перенаправления.

Плагин передаёт сумму заказа в валюте заказа, номер заказа как описание (Order и номер) и адрес e-mail покупателя из платёжных данных. На странице Autopay покупатель выбирает способ оплаты и платит.

После оплаты покупатель возвращается на страницу «Заказ получен». Адрес возврата подписан, но он никогда не меняет статус заказа. Заказ отмечается оплаченным только после того, как Autopay подтвердит его подписанным ITN, а сумма и валюта совпадут с заказом.

Если платёж не прошёл, заказ переходит в статус Failed, и покупатель может оплатить его снова из заказа по ссылке Pay. Если платёж не удаётся начать, покупатель видит короткое сообщение, например Autopay payments are not configured. Please choose another payment method or contact the store. или сообщение о том, что Autopay не принимает платежи в этой валюте.

Способ оплаты работает в классическом оформлении заказа, в блоке «Оформление заказа» и на странице Pay for order. Он совместим с High-Performance Order Storage (HPOS) WooCommerce.

В плагине нет возвратов из WooCommerce, подписок и регулярных платежей, сохранённых карт (1-Click), кода BLIK или формы карты на странице оформления заказа, а также выбора банка или платёжного канала на этой странице. Плагин использует один Service ID на каждую среду.

Заказы

Статусы заказа

Pending payment: покупатель отправлен в Autopay, и Autopay ещё не подтвердил платёж.

Processing или Completed: Autopay подтвердил платёж. WooCommerce ставит Processing, а Completed — для заказов только с виртуальными загружаемыми товарами. Примечание к заказу показывает сумму, транзакцию Autopay и дату платежа. ID транзакции — это ID транзакции Autopay (RemoteID).

On hold: Autopay сообщил сумму или валюту, отличные от итога заказа. Заказ не отмечен оплаченным. Проверьте транзакцию в портале Autopay и вручную завершите её или сделайте возврат.

Failed: платёж не прошёл. Покупатель может оплатить заказ снова.

Оплаченный заказ никогда не меняется более поздним уведомлением о неуспехе. Если Autopay сообщает о ещё одном успешном платеже по оплаченному заказу, примечание предупреждает, что покупатель мог заплатить дважды. Уведомление о платеже, начатом через другой сервис Autopay, не применяется, и примечание это объясняет.

Возвраты

Возвраты из WooCommerce не поддерживаются. Сделайте возврат платежа в портале Autopay, затем зафиксируйте его в WooCommerce ручным возвратом.

Лицензионный ключ

Плагин работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии находится вверху страницы WooCommerce > Settings > Payments > Autopay. Вставьте ключ в поле License key и нажмите Activate. В блоке показан статус, например дата окончания действия лицензии и ваш домен. Используйте Check now, чтобы проверить статус снова, Change key, чтобы ввести другой ключ, и Remove key, чтобы удалить его с этого сайта. Ссылка Manage licenses and domains in your account открывает ваш аккаунт на vibefox.net.

Один ключ работает на одном домене. Удаление ключа с сайта не освобождает слот домена. Освободите слот в вашем аккаунте на vibefox.net.

Без активного ключа Autopay не показывается покупателям при оформлении заказа. Если оплата всё же начата, покупатель видит сообщение This payment method is not available. Please choose another one. Менеджеры магазина, вошедшие в систему, по-прежнему видят способ оплаты с пометкой (unlicensed — visible to admins only), чтобы вы могли настроить и протестировать плагин до покупки ключа. Напоминание появляется на странице Plugins и на страницах WooCommerce. Существующие заказы не затрагиваются: уже начатые платежи по-прежнему подтверждаются.

Когда срок лицензии истекает, плагин продолжает работать, но для обновлений и поддержки нужно продление. Статус снова проверяется автоматически в фоновом режиме.

Устранение неполадок

Autopay не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено, у выбранной среды есть Service ID и Shared key, а валюта магазина выбрана в Currencies. Страница настроек показывает предупреждение, если чего-то из этого не хватает.

Оплата прошла, но заказ остаётся в статусе Pending payment: Autopay не доставил ITN, либо магазин его отклонил. Проверьте, что URL ITN из настроек указан для сервиса в портале Autopay (рабочем или тестовом), что хэш-функция — SHA-256 и что Shared key в плагине совпадает с сервисом. Проверьте, что магазин доступен из интернета. Включите Logging и посмотрите в WooCommerce > Status > Logs, источник wcp_autopay_payment.

В журнале: ITN rejected: invalid hash: Shared key не совпадает с сервисом, либо хэш-функция сервиса не SHA-256.

В журнале сообщение о том, что Service ID не настроен: уведомление пришло от сервиса, Service ID которого не введён в плагин.

Заказ переведён в On hold с примечанием о несовпадении: Autopay сообщил сумму или валюту, отличные от итога заказа. Проверьте транзакцию в портале Autopay и вручную завершите заказ или сделайте возврат.

Примечание говорит, что уведомление НЕ применено: платёж по этому заказу был начат не через этот сервис Autopay, например тестовое уведомление для рабочего заказа. Проверьте транзакцию в портале Autopay.

После оплаты покупатель попадает на главную страницу: адрес возврата не удалось проверить, например потому что Service ID не введён в плагин. Статус заказа от этого не меняется: он следует за ITN.

Блок лицензии показывает ошибку: следуйте сообщению в блоке. Например, если ключ уже используется на другом домене, освободите слот в вашем аккаунте на vibefox.net и нажмите Check now. Если адрес сайта изменился, нажмите Check now, чтобы активировать ключ для нового домена. Если сервер лицензий недоступен, плагин продолжает работать по последнему известному статусу.

Удаление

Деактивация плагина сохраняет все данные. Чтобы удалить плагин, деактивируйте его и удалите на странице Plugins. Лицензионный ключ и статус лицензии этого плагина, а также настройки платёжного шлюза удаляются. В плагине нет опции сохранения настроек. Существующие заказы сохраняют свои примечания об оплате и ID транзакций.

Autopay — товарный знак соответствующего правообладателя. Этот плагин не связан с Autopay и не одобрен ею.