VibeFox ePayco for WooCommerce — Помощь

Требования

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

WooCommerce: 7.0 или новее, установлен и активен. Плагин не активируется без него.

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

Валюта магазина: колумбийское песо (COP) или доллар США (USD). Для других валют способ оплаты скрыт на странице оформления заказа.

Учётная запись ePayco: нужны четыре ключа вашей учётной записи ePayco: P_CUST_ID_CLIENTE, P_KEY, PUBLIC_KEY и PRIVATE_KEY. Они находятся в панели ePayco в разделе Integrations, API keys. Одни и те же ключи работают в тестовом и рабочем режиме. Способы оплаты, которыми может пользоваться покупатель (карты, PSE, сети оплаты наличными, кошельки), — это те, что включены в вашей учётной записи ePayco.

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

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите четыре ключа ePayco и выберите тип оформления (см. раздел «Настройка»).

6. Включите Enable/Disable. Проверьте платёж в Test Mode тестовыми картами ePayco, затем снимите отметку с Test Mode.

Настройка

Все параметры находятся на одной странице: WooCommerce > Settings > Payments > ePayco. Над полями страница предупреждает, если введены не все четыре ключа (тогда способ оплаты скрыт на странице оформления заказа), если валюта магазина не COP и не USD, и показывает Test mode is on: customers pay with ePayco test cards and no real money is charged. пока включён тестовый режим. В списке способов оплаты ePayco помечен как требующий настройки, пока не введены все четыре ключа.

Общие

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

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

Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay securely with ePayco.

Ключи учётной записи ePayco

Четыре ключа находятся в панели ePayco в разделе Integrations, API keys. P_CUST_ID_CLIENTE и P_KEY проверяют подтверждения платежей; PUBLIC_KEY и PRIVATE_KEY создают сессии оплаты. Одни и те же ключи работают в тестовом и рабочем режиме.

Customer ID (P_CUST_ID_CLIENTE): ваш ID клиента ePayco (числовой).

Secret Key (P_KEY): используется для проверки подписи подтверждений платежей ePayco. Храните в секрете.

Public Key (PUBLIC_KEY): ваш публичный ключ API ePayco.

Private Key (PRIVATE_KEY): ваш приватный ключ API ePayco. Храните в секрете.

Test Mode: Enable test mode создаёт сессии оплаты как тестовые транзакции. Покупатели платят тестовыми картами ePayco, реальные деньги не списываются. Тестовые транзакции никогда не оплачивают заказы, созданные в рабочем режиме. По умолчанию: выключено.

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

Checkout Type: как открывается платёжная форма ePayco.

URL подтверждения

URL подтверждения сообщает вашему магазину результат платежа. Он автоматически передаётся в ePayco с каждым платежом, поэтому в панели ePayco ничего настраивать не нужно. В разделе показан URL, он выглядит так: https://your-site/wc-api/epc_p/. Он должен быть доступен из интернета и не блокироваться режимом обслуживания, брандмауэром или базовой HTTP-аутентификацией.

Каждое подтверждение должно содержать действительную подпись, созданную с вашими P_CUST_ID_CLIENTE и P_KEY. Подтверждения без действительной подписи отклоняются и не меняют заказ. Без подтверждения заказ обновляется, только когда покупатель возвращается в магазин после оплаты.

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

Logging: Enable logging записывает ошибки API и подтверждения платежей в WooCommerce > Status > Logs, источник wcp_epayco_payment. Ключи и данные покупателей не записываются. По умолчанию: выключено.

Delete Data on Uninstall: Remove the gateway settings and logs when the plugin is deleted. Деактивация плагина ничего не удаляет. Данные ePayco, сохранённые в заказах, остаются. По умолчанию: выключено.

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

Покупатель выбирает способ оплаты (по умолчанию ePayco) и оформляет заказ. Плагин создаёт сессию оплаты ePayco на сумму заказа в валюте заказа с налогами заказа, номером заказа и именем, адресом, e-mail и телефоном для выставления счёта. Язык платёжной формы — испанский или английский, в зависимости от языка сайта. Затем покупатель попадает на страницу оплаты заказа, где видит Thank you for your order. The secure ePayco checkout opens automatically; if it does not, click the button below. Платёжная форма ePayco открывается во всплывающем окне или перенаправлением, в зависимости от Checkout Type. На странице также есть кнопка Pay with ePayco и ссылка Choose another payment method. В тестовом режиме страница и платёжная форма показывают TEST MODE — use ePayco test cards, no real money is charged.

В платёжной форме ePayco покупатель платит одним из способов, включённых в вашей учётной записи ePayco. После этого ePayco отправляет подтверждение в ваш магазин и возвращает покупателя. Заказ отмечается оплаченным только после подтверждения ePayco: по подписанному подтверждению или по серверному запросу к ePayco при возврате покупателя. Один лишь возврат покупателя никогда не оплачивает заказ.

Если платёж ещё не подтверждён, страница «Заказ получен» показывает We are waiting for ePayco to confirm your payment. This page does not need to stay open. Для ожидающего платежа (например, PSE или наличными) она показывает Your ePayco payment is being confirmed. We will e-mail you as soon as it is approved.

Если платёж отклонён, покупатель возвращается на страницу Pay for order с сообщением Your ePayco payment was declined or could not be completed. You can try again or choose another payment method. Если покупатель вернулся без оплаты, сообщение такое: The ePayco payment was not completed. If you already paid, the order will be updated as soon as ePayco confirms it; otherwise you can try again.

Если ePayco не может начать платёж, покупатель видит короткое сообщение, например We could not connect to ePayco. Please try again in a moment or choose another payment method. Причина добавляется в примечания к заказу и в журнал.

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

Плагин принимает только разовые платежи. Возвратов из WooCommerce, сохранённых карт, подписок и разделённых платежей нет, а плагин не запрашивает ePayco об ожидающих транзакциях: заказы обновляются подтверждением ePayco и возвратом покупателя.

Заказы

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

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

Processing: платёж принят (заказы только с виртуальными загружаемыми товарами переходят в статус «Выполнен» — значение WooCommerce по умолчанию). В примечании к заказу показаны идентификатор ePayco, состояние, сумма, способ оплаты и код одобрения. ID транзакции заказа — это идентификатор ePayco (ref_payco).

On hold, payment pending: ePayco сообщил, что платёж ожидает подтверждения или удержан, например перевод PSE или оплата наличными. Заказ автоматически изменится, когда ePayco подтвердит или отклонит платёж.

On hold, amount/currency mismatch: ePayco одобрил платёж, сумма или валюта которого отличается от заказа. Не отправляйте заказ, пока не проверите транзакцию в панели ePayco.

On hold, payment for a cancelled order: ePayco одобрил платёж после того, как заказ был отменён. Восстановите заказ или оформите возврат в ePayco.

Failed: платёж отклонён, завершился ошибкой, истёк, был прерван, отменён или остановлен антифрод-системой. В примечании указана причина от ePayco. Покупатель может повторить попытку. Поздний сбой никогда не меняет оплаченный заказ.

Refunded: ePayco вернул платёж по этому заказу.

Если ePayco сообщает о другом одобренном платеже по уже оплаченному заказу, статус не меняется. Примечание просит проверить двойное списание и при необходимости вернуть его в ePayco. Тестовая транзакция для заказа, оформленного в рабочем режиме, и транзакция, уже принадлежащая другому заказу, игнорируются с примечанием.

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

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

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

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

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

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

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

ePayco не отображается при оформлении заказа: проверьте, что лицензия активна, включён Enable/Disable, введены все четыре ключа и валюта магазина — COP или USD. На странице Pay for order проверяется валюта заказа. Страница настроек показывает предупреждение, если чего-то не хватает.

Платёж прошёл, но заказ остаётся Pending payment: подтверждение ePayco не доходит до вашего магазина. Проверьте, что URL подтверждения из настроек открывается из интернета и не блокируется режимом обслуживания, брандмауэром, плагином безопасности или базовой HTTP-аутентификацией. Включите Logging и посмотрите WooCommerce > Status > Logs, источник wcp_epayco_payment. Заказ также обновится, когда покупатель вернётся в магазин после оплаты.

Подтверждение отвечает Invalid signature: Customer ID (P_CUST_ID_CLIENTE) или Secret Key (P_KEY) не совпадает с учётной записью ePayco, которая приняла платёж. Скопируйте оба значения заново из панели ePayco.

Подтверждение отвечает Gateway not configured: P_CUST_ID_CLIENTE или P_KEY пусто. Введите их в настройках.

Подтверждение отвечает Busy, retry later: заказ в этот момент обновлял другой запрос. ePayco повторит подтверждение.

Покупатель видит We could not connect to ePayco: ePayco отклонил PUBLIC_KEY и PRIVATE_KEY. В примечании к заказу показан ответ ePayco. Скопируйте оба ключа заново.

Покупатель видит ePayco could not start the payment: ePayco не создал сессию оплаты. Посмотрите в примечании к заказу ошибку ePayco.

Платёжная форма ePayco не открывается: покупатель видит The ePayco checkout could not be loaded. Please reload the page or choose another payment method. Скрипт платёжной формы ePayco не удалось загрузить на странице оплаты заказа. Покупатель может перезагрузить страницу или выбрать Choose another payment method.

Тестовый платёж не оплатил заказ: тестовые транзакции никогда не оплачивают заказы, оформленные в рабочем режиме. Оформите тестовый заказ, когда включён Test Mode.

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

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

Для разработчиков документация плагина описывает фильтры epc_p_supported_currencies (валюты, для которых предлагается способ оплаты), epc_p_session_payload (данные, отправляемые в ePayco) и epc_p_icon (значок платёжной формы).

Удаление

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

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