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 підтвердження вашого магазину має бути доступним з інтернету та не блокуватися режимом обслуговування, брандмауером або базовою автентифікацією.

Ліцензійний ключ 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/. Він має бути доступним з інтернету та не блокуватися режимом обслуговування, брандмауером або базовою автентифікацією.

Кожне підтвердження має містити дійсний підпис, створений з вашими 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. Причина додається до приміток замовлення та журналу.

Спосіб оплати працює в класичному оформленні замовлення, у блоці Checkout і на сторінці 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 підтвердження з налаштувань відкривається з інтернету та не блокується режимом обслуговування, брандмауером, плагіном безпеки або базовою автентифікацією. Увімкніть 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.