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.