VibeFox Wompi for WooCommerce — Помощь

Требования

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

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

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

Валюта магазина: колумбийское песо (COP). Wompi Colombia принимает платежи в COP, а способ оплаты скрыт для заказов в других валютах.

Аккаунт Wompi: учётная запись мерчанта Wompi Colombia. У каждой среды (sandbox и production) четыре ключа: публичный ключ, приватный ключ, секрет событий и секрет целостности. Найти их можно в панели мерчанта Wompi (comercios.wompi.co) в разделе для разработчиков. Wompi El Salvador и Panama используют другие API и не поддерживаются.

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

Установка

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

2. Нажмите Activate.

3. Установите валюту магазина колумбийское песо (COP) в WooCommerce > Settings > General.

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

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

6. Вставьте ключи sandbox и production из панели мерчанта Wompi и укажите Events URL в Wompi (см. Настройка).

7. Включите Enable/Disable. Проверьте платёж в режиме sandbox, затем снимите отметку Sandbox mode, чтобы принимать реальные платежи.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Wompi. Над полями блок статуса показывает текущий режим, SANDBOX или PRODUCTION. Если ключа этого режима нет, блок его перечисляет и сообщает, что способ оплаты скрыт при оформлении заказа, пока не заданы все ключи этой среды. Когда все ключи заданы, блок сообщает, списываются ли реальные платежи. При сохранении плагин предупреждает, если ключ не начинается с префикса своего раздела, и если Wompi включён, но скрыт при оформлении заказа из-за отсутствующих ключей. В списке способов оплаты Wompi помечается как требующий настройки, пока в текущем режиме не заданы все четыре ключа. Ключи версии 1.0 при обновлении автоматически переносятся в соответствующий раздел Sandbox или Production.

Общие

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

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

Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay securely with Wompi: cards, PSE, Nequi, Bancolombia and more.

Аккаунт Wompi

Скопируйте ключи из панели мерчанта Wompi (comercios.wompi.co), раздел для разработчиков. У каждой среды свои публичный ключ, приватный ключ, секрет событий и секрет целостности.

Sandbox mode: Use the Wompi sandbox (sandbox keys, no real money). Переключает и ключи, и API Wompi (sandbox.wompi.co или production.wompi.co). Заказы сохраняют среду, в которой были оплачены. По умолчанию: включено. Снимите отметку, чтобы принимать реальные платежи.

Ключи sandbox

Четыре ключа песочницы Wompi. Они начинаются с pub_test_, prv_test_, test_events_ и test_integrity_.

Public key: публичный ключ sandbox (pub_test_...). Он идентифицирует ваш аккаунт в Wompi Web Checkout.

Private key: приватный ключ sandbox (prv_test_...). Используется для чтения транзакций из API Wompi.

Events secret: секрет событий sandbox (test_events_...). Проверяет подпись событий Wompi.

Integrity secret: секрет целостности sandbox (test_integrity_...). Подписывает запрос на оплату, отправляемый в Web Checkout.

Ключи production

Четыре ключа производственной среды Wompi. Они начинаются с pub_prod_, prv_prod_, prod_events_ и prod_integrity_.

Public key: публичный ключ production (pub_prod_...).

Private key: приватный ключ production (prv_prod_...).

Events secret: секрет событий production (prod_events_...).

Integrity secret: секрет целостности production (prod_integrity_...).

Events URL (вебхук)

События Wompi сообщают вашему магазину, что транзакция изменилась. В панели мерчанта Wompi, в разделе для разработчиков, укажите Events URL, который показан в этом разделе настроек, для sandbox и для production. Выглядит он так: https://your-site/wc-api/wompi_p/. Скопируйте URL точно так, как он показан в настройках.

Плагин использует это событие:

Другие события получают ответ Ignored. Каждое событие проверяется секретом событий своей среды (sandbox или production). События без корректной подписи отклоняются. После проверки транзакция читается из API Wompi, и используются только эти данные. Без Events URL заказ подтверждается только тогда, когда покупатель возвращается в магазин после оплаты.

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

Debug log: Log payment and webhook activity записывает активность платежей и событий в WooCommerce > Status > Logs, источник wcp_wompi_payment. Ошибки записываются всегда, даже когда эта опция выключена. Ключи, секреты и данные покупателей никогда не записываются в журнал. По умолчанию: выключено.

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

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

Покупатель выбирает способ оплаты (по умолчанию Wompi) и оформляет заказ. В режиме sandbox под описанием появляется Sandbox mode: no real payment is made. Плагин создаёт попытку оплаты со своим номером (WC-, номер заказа и отметка времени), подписывает её секретом целостности и отправляет покупателя в Wompi Web Checkout с суммой заказа в COP. E-mail для выставления счёта и имя покупателя передаются в Wompi. Примечание к заказу фиксирует среду, номер и сумму.

На странице Wompi покупатель платит любым способом, включённым в вашем аккаунте Wompi. Затем Wompi возвращает покупателя на страницу «Заказ получен» вашего магазина. Заказ отмечается оплаченным только после подтверждения Wompi: подписанным событием или серверным запросом к API Wompi, когда покупатель попадает на эту страницу. Номеру транзакции в самом адресе возврата плагин не доверяет. При перезагрузке страницы транзакция проверяется повторно не чаще одного раза в 20 секунд.

Оплатить заказ могут только транзакции, созданные для этого заказа, и только в среде попытки. Покупатель может оплатить неоплаченный заказ повторно, например со страницы Pay for order. Каждая попытка получает новый номер.

Способ оплаты показывается, только если лицензия активна, все четыре ключа текущего режима заданы, валюта заказа COP и сумма не меньше COP 1 500. Если оплату не удаётся начать, покупатель видит короткое сообщение и может выбрать другой способ оплаты:

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

Плагин не делает возвраты из WooCommerce. На вашем сайте нет сохранённых карт, подписок и полей для ввода карты: все платёжные данные вводятся в Wompi.

Заказы

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

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

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

Processing or Completed: транзакция одобрена. Применяется стандарт WooCommerce: В обработке, или Выполнен для заказов только с виртуальными загружаемыми товарами. В примечании к заказу показаны транзакция Wompi, тип способа оплаты (например, карта, PSE или Nequi) и номер. ID транзакции заказа — это ID транзакции Wompi.

On hold after payment: Wompi одобрил сумму или валюту, отличные от суммы заказа (например, заказ был изменён после начала оплаты), либо платёж был одобрен после отмены заказа. Заказ не отмечается оплаченным. Примечание к заказу объясняет это. Проверьте платёж в панели Wompi и либо выполните заказ, либо сделайте возврат платежа.

Failed: транзакция последней попытки оплаты была отклонена или завершилась ошибкой. Сообщение Wompi добавляется в примечание. Результаты более ранних попыток заказ не меняют.

Cancelled: транзакция последней попытки оплаты была отменена в Wompi до того, как заказ был оплачен.

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

Возвраты

Возвраты не отправляются из WooCommerce. Верните или отмените платёж в панели мерчанта Wompi, затем зафиксируйте ручной возврат в WooCommerce. Отмена, выполненная в Wompi, добавляется к заказу как примечание.

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

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

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

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

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

Решение проблем

Wompi не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включён и заданы все четыре ключа текущего режима (блок статуса на странице настроек перечисляет недостающие ключи). Проверьте также, что валюта заказа COP и сумма заказа не меньше COP 1 500.

Платёж прошёл, но заказ остаётся в Pending payment: Events URL не работает. В панели Wompi проверьте, что Events URL задан для используемой среды (sandbox или production) и совпадает с тем, что показано в настройках. Проверьте, что секрет событий этой среды находится в соответствующем разделе. Заказ также подтверждается, когда покупатель возвращается в магазин после оплаты.

Events URL отвечает Not configured: секрет событий среды события пуст. Вставьте его в настройки.

Events URL отвечает Invalid signature: секрет событий принадлежит другой среде или другому аккаунту. Скопируйте его заново из панели Wompi.

Events URL отвечает Transaction lookup failed: API Wompi не вернул транзакцию, например из-за неверного приватного ключа или проблемы с сетью. Wompi отправит событие повторно позже.

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

Events URL отвечает Environment mismatch: транзакция sandbox пришла для попытки оплаты production или наоборот. Платежи sandbox никогда не подтверждают заказы production.

Предупреждение при сохранении «The key does not start with ...»: ключ вставлен не в тот раздел. Ключи sandbox начинаются с pub_test_, prv_test_, test_events_ и test_integrity_, ключи production — с pub_prod_, prv_prod_, prod_events_ и prod_integrity_.

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

Другие ошибки: откройте примечания к заказу или WooCommerce > Status > Logs, источник wcp_wompi_payment. Ошибки всегда записываются. Включите Debug log для подробностей. Разработчики могут разрешить другую валюту фильтром wompi_p_supported_currencies, если аккаунт Wompi её принимает.

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

Удаление

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

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