VibeFox Conekta for WooCommerce — Допомога

Вимоги

WordPress: 6.0 або новіша версія.

WooCommerce: 8.0 або новіша, встановлений і активний. Плагін не активується без нього.

PHP: 8.0 або новіша версія.

Валюта: валюта магазину має бути MXN або USD. Для інших валют спосіб оплати приховується.

Обліковий запис Conekta: потрібні Private Key вашого облікового запису Conekta (тестовий і робочий) та вебхук у панелі Conekta (див. розділ «Налаштування»). Використовуються лише Private Key. Public Key не потрібен, бо оплата відбувається на платіжній сторінці Conekta.

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

Встановлення

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

2. Натисніть Activate.

3. Відкрийте налаштування: WooCommerce > Settings > Payments > Conekta > Manage або натисніть Settings під назвою плагіна на сторінці «Плагіни».

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

5. Введіть тестовий і робочий Private Key, оберіть режим і додайте вебхук у панелі Conekta (див. розділ «Налаштування»).

6. Увімкніть Enable / Disable і збережіть. Перевірте оплату в тестовому режимі, а потім зніміть позначку з Test mode.

Налаштування

Усі налаштування розміщені на одній сторінці: WooCommerce > Settings > Payments > Conekta. Над полями сторінка попереджає, коли Conekta увімкнено, але Private Key поточного режиму порожній (тоді спосіб оплати приховується на оформленні замовлення), і коли валюта магазину не MXN та не USD. Поки тестовий режим увімкнено, сторінка показує Test mode is on: payments are simulated with the test private key. Якщо зберегти увімкнений шлюз без ключа поточного режиму, з'явиться повідомлення про помилку з проханням ввести його.

Загальні

Enable / Disable: Enable Conekta payments вмикає або вимикає спосіб оплати. За замовчуванням: вимкнено.

Title: назва способу оплати, яку покупець бачить на оформленні замовлення. За замовчуванням: Conekta.

Description: текст під способом оплати на оформленні замовлення. За замовчуванням: Pay securely with card, OXXO cash or SPEI transfer. You will be redirected to Conekta to complete your payment.

Payment methods: способи, які пропонуються на платіжній сторінці Conekta. За замовчуванням: картка, готівка та банківський переказ. Готівка, SPEI та BNPL доступні лише для замовлень у MXN (замовлення в USD приймають лише картки) і мають бути увімкнені у вашому обліковому записі Conekta. Якщо нічого не вибрано, використовується картка.

API-ключі

Скопіюйте Private Key з панелі Conekta в розділі Developers > API keys. Тестовий і робочий ключі відрізняються.

Test mode: Enable test mode використовує тестовий Private Key. Реальні гроші не списуються, а на оформленні замовлення з'являється значок TEST MODE. Повернення коштів завжди використовують ключ того режиму, в якому було здійснено платіж. За замовчуванням: увімкнено.

Test private key: Private Key з тестового режиму вашого облікового запису Conekta.

Live private key: Private Key з робочого режиму вашого облікового запису Conekta. Тримайте його в таємниці.

Кожне замовлення Conekta запам'ятовує свій режим: повідомлення та повернення коштів використовують відповідний ключ. Тримайте обидва ключі заповненими, поки відкриті старі тестові замовлення.

Вебхук

Вебхук повідомляє вашому магазину про платежі, здійснені після того, як покупець залишив сторінку Conekta, наприклад про оплати через OXXO або SPEI. У панелі Conekta перейдіть до Developers > Webhooks і додайте URL, наведений у цьому розділі, окремо для тестового та робочого режиму. Він має такий вигляд: https://your-site/wc-api/webhook_wc_conekta/.

Виберіть ці події:

Тіло вебхука лише повідомляє плагіну, яке замовлення Conekta змінилося. Кожне повідомлення перевіряється шляхом повторного читання замовлення через API Conekta з Private Key його режиму; заголовок підпису Digest у вебхуку не використовується. Повідомлення про замовлення Conekta, які цей магазин не створював для цього замовлення, приймаються та ігноруються. Без вебхука замовлення підтверджується лише тоді, коли покупець повертається до магазину після оплати, або під час наступної спроби оплатити те саме замовлення.

Додатково

Debug log: Log API calls and notifications записує деталі в WooCommerce > Status > Logs, джерело wcp_conekta_gateway. Помилки завжди записуються. Журнали ніколи не містять ключів API чи контактних даних покупця. За замовчуванням: вимкнено.

Delete data on uninstall: Remove the settings, Conekta order references and logs when the plugin is deleted. За замовчуванням: вимкнено.

Оформлення замовлення

Покупець обирає спосіб оплати (за замовчуванням Conekta) і оформлює замовлення. Плагін створює замовлення Conekta на суму замовлення у валюті замовлення, з товарами, доставкою, податками та знижками, і надсилає покупця на платіжну сторінку Conekta. Там покупець платить одним із дозволених способів.

Після оплати покупець повертається до вашого магазину. Замовлення позначається оплаченим лише після підтвердження Conekta: плагін читає замовлення через API Conekta, коли надходить вебхук, і коли покупець повертається. Якщо платіж ще не можна підтвердити, на сторінці «Замовлення отримано» показується We are confirming your payment with Conekta. The order will be updated automatically — please do not pay again. Якщо покупець обрав OXXO або SPEI і отримав платіжний референс, замовлення переходить у статус «На утриманні», а на сторінці показується Your Conekta payment reference has been issued. The order will be confirmed as soon as the payment is received.

Якщо платіж відхилено, замовлення отримує статус «Невдалий», а покупець повертається на сторінку Pay for order з повідомленням The Conekta payment was not completed. Please try again or choose another payment method. Якщо платіжна сторінка прострочена або скасована, покупець бачить The Conekta payment has expired or was cancelled. Please place the order again. Коли покупець оплачує замовлення повторно, відкрита платіжна сторінка Conekta на ту саму суму використовується повторно; інакше попередня скасовується в Conekta перед створенням нової, тож старе посилання не можна оплатити двічі. Якщо попередню сторінку вже було оплачено, платіж зараховується, а не списується повторно.

Якщо Conekta не може розпочати платіж, покупець бачить коротке повідомлення, наприклад The payment could not be started. Please try again in a moment or choose another payment method. Технічна причина записується в журнал.

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

Плагін приймає платежі лише на сторінці Conekta. На сторінці оформлення замовлення немає форми картки, збережених карток, підписок, попередньої авторизації та захоплення, а також щомісячного розстрочення (MSI).

Замовлення та повернення коштів

Статуси замовлень

Pending payment: покупця перенаправлено до Conekta, і він ще не оплатив. Примітка до замовлення показує замовлення Conekta та режим.

Processing: Conekta підтвердив платіж з тією самою сумою та валютою (замовлення, що містять лише віртуальні товари для завантаження, переходять у статус «Виконано» — значення WooCommerce за замовчуванням). Примітка до замовлення показує спосіб оплати (наприклад, бренд картки та останні чотири цифри, OXXO / готівка або банківський переказ SPEI), замовлення Conekta та списання. ID транзакції замовлення — це ID списання Conekta (charge ID).

On hold, waiting for OXXO or SPEI: покупець отримав платіжний референс. Замовлення переходить у статус «Обробляється», коли Conekta повідомляє про платіж.

On hold after payment: сума або валюта, отримані від Conekta, не збігаються із замовленням; платіж у тестовому режимі надійшов, поки магазин працював у робочому режимі (реальні гроші не отримано), або платіж надійшов для вже скасованого замовлення. Примітка до замовлення пояснює це. Перевірте платіж, а потім завершіть замовлення або поверніть кошти. Замовлення, яке в Conekta лише попередньо авторизоване, також переходить у статус «На утриманні» з приміткою: захопити або анулювати його в панелі Conekta.

Failed: платіж відхилено. Примітка показує причину. Покупець може оплатити знову.

Cancelled: поточна платіжна сторінка Conekta прострочена або скасована.

Оплачене або повернене замовлення ніколи не понижується в статусі та не відкривається знову. Якщо для вже оплаченого замовлення надходить ще один платіж Conekta, примітка WARNING просить повернути його в панелі Conekta.

Повернення коштів

Відкрийте замовлення, натисніть Refund, введіть суму та натисніть Refund via Conekta (кнопка показує назву способу оплати). Підтримуються повні та часткові повернення. Повернення надсилається на замовлення Conekta, що містить платіж, і використовує ключ режиму, в якому було здійснено платіж, тому цей ключ має бути заданий. Якщо Conekta не приймає повернення, WooCommerce показує помилку, і повернення не реєструється. Успішне повернення додається до приміток замовлення з сумою, режимом, замовленням Conekta, ID повернення та причиною.

Повернення, здійснені в панелі Conekta, надходять через вебхук і додаються як примітка із сумою, повернутою в Conekta і в WooCommerce. Вони не реєструються автоматично як повернення WooCommerce. Зареєструйте їх вручну, не використовуючи Refund via Conekta. Чарджбек, про який повідомила Conekta, також додається як примітка.

Ліцензійний ключ

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

Один ключ працює на одному домені. Видалення ключа з сайту не звільняє його місце для домену. Звільніть місце у своєму обліковому записі vibefox.net.

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

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

Усунення несправностей

Conekta не з'являється на оформленні замовлення: перевірте, що ліцензія активна, що Enable / Disable увімкнено, що Private Key поточного режиму заповнений (Test private key у тестовому режимі, Live private key у робочому режимі) і що валюта магазину — MXN або USD. Сторінка налаштувань показує попередження для кожної з цих умов.

Платіж пройшов, але замовлення залишається в статусі Pending payment: вебхук не працює. У панелі Conekta перевірте, що вебхук існує для режиму, який ви використовуєте (тестового чи робочого), що його URL точно збігається з URL із налаштувань і що події вибрані. Перевірте, що Private Key цього режиму задано, оскільки кожне повідомлення перевіряється ним. Замовлення також підтверджується, коли покупець повертається до магазину або намагається оплатити те саме замовлення знову.

Вебхук відповідає Temporarily unavailable: API Conekta недоступний, Private Key режиму замовлення відсутній або замовлення вже оброблялося іншим запитом. Conekta повторює вебхук.

Вебхук відповідає Verification failed, Invalid payload або Invalid order id: API Conekta не підтвердив замовлення, або повідомлення не було коректною подією замовлення Conekta.

Вебхук відповідає Ignored: повідомлення стосується замовлення Conekta, яке цей магазин не створював для цього замовлення (наприклад, іншого магазину чи платіжного посилання на тому самому обліковому записі), або об'єкта, відмінного від замовлення.

Покупець бачить We could not check the status of your previous payment attempt: попередню платіжну сторінку Conekta для замовлення не вдалося прочитати, тому нову не створюють, щоб уникнути подвійної оплати. Спробуйте за кілька хвилин.

Покупець бачить Payment gateway is not configured: Private Key поточного режиму відсутній.

Замовлення в статусі On hold: прочитайте примітки до замовлення. Покупець ще не оплатив референс OXXO або SPEI, сума чи валюта не збіглися, або платіж у тестовому режимі надійшов, поки магазин працював у робочому режимі.

Повернення коштів не проходить з повідомленням про тестовий або робочий режим: платіж було здійснено в цьому режимі, а його Private Key не задано. Введіть його та спробуйте ще раз.

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

Для розробників: readme описує фільтр wc_ckt_supported_currencies для списку валют.

Видалення

Деактивація плагіна зберігає всі дані. Щоб видалити плагін, деактивуйте його та видаліть на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна завжди видаляються. Налаштування шлюзу, посилання на замовлення Conekta, збережені в замовленнях, і журнали видаляються лише якщо було ввімкнено Delete data on uninstall. Інакше вони зберігаються для повторного встановлення. Існуючі замовлення зберігають свої платіжні примітки та ID транзакцій.

Conekta — торговельна марка відповідного власника. Цей плагін не пов'язаний із Conekta і не схвалений компанією Conekta.