VibeFox 2C2P for WooCommerce — Допомога

Вимоги

WordPress: 5.8 або новіша.

WooCommerce: 6.0 або новіша, встановлений і активний. Без WooCommerce плагін показує повідомлення в адміністративній частині, а спосіб оплати не завантажується.

PHP: 8.0 або новіша.

Обліковий запис 2C2P: потрібні Merchant ID та Secret Key вашого облікового запису мерчанта 2C2P. Їх видає 2C2P під час відкриття облікового запису мерчанта. Тестове середовище (sandbox) і робочий режим мають різні ключі. Документація для розробників і тестові картки sandbox — на developer.2c2p.com.

Валюта: валюта магазину має підтримуватися плагіном і бути увімкненою у вашому обліковому записі 2C2P. Серед підтримуваних, зокрема, THB, SGD, MYR, PHP, IDR, VND, MMK, KHR, LAK, CNY, HKD, TWD, JPY, KRW, INR, AUD, NZD, USD, EUR та GBP. Якщо валюта магазину не підтримується, спосіб оплати приховується під час оформлення замовлення.

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

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

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

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

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

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

5. Введіть Merchant ID і Secret Key для тестового середовища, увімкніть Enable/Disable і зробіть тестове замовлення.

6. Коли будете готові, введіть робочі облікові дані та зніміть позначку з Sandbox Mode.

Адреси повернення та сповіщення надсилаються з кожним платежем. Нічого не потрібно налаштовувати в порталі 2C2P.

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

Усі параметри розміщені на одній сторінці: WooCommerce > Settings > Payments > 2C2P. Над полями сторінка показує Sandbox mode is active. No real transactions will be processed., поки режим sandbox увімкнено. Сторінка попереджає, коли шлюз увімкнено, але Merchant ID або Secret Key поточного режиму порожні, а також коли валюта магазину не підтримується. В обох випадках спосіб оплати приховується під час оформлення замовлення. Коли ви зберігаєте налаштування з вимкненим Sandbox Mode, плагін просить ввести робочі Merchant ID та Secret Key, якщо вони порожні.

Загальні

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

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

Description: текст під способом оплати під час оформлення замовлення. За замовчуванням: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P. У тестовому режимі до нього додається (TEST MODE).

Тестове середовище (sandbox)

Sandbox Mode: Enable sandbox / test mode надсилає платежі в тестове середовище 2C2P (demo2.2c2p.com) з тестовими обліковими даними нижче. За замовчуванням: увімкнено. Зніміть позначку, щоб приймати справжні платежі.

Sandbox Merchant ID: ваш Merchant ID 2C2P для тестового середовища.

Sandbox Secret Key: ваш Secret Key 2C2P для тестового середовища.

Облікові дані робочого API

Використовуються, коли режим sandbox вимкнено.

Merchant ID: ваш робочий Merchant ID 2C2P. Обов'язковий, коли режим sandbox вимкнено.

Secret Key: ваш робочий Secret Key 2C2P. Обов'язковий, коли режим sandbox вимкнено. Ключ зберігається точно так, як введено, включно з лапками та оберненими скісними рисками (backslash).

Сторінка оплати

Цей розділ для довідки показує адресу повернення покупця на сайт (https://your-site/?wc-api=tc2p_p) та адресу серверного сповіщення (https://your-site/?wc-api=tc2p_p&tc2p_p_s2s=1). Вони автоматично надсилаються з кожним платежем.

Payment Page Language: мова платіжної сторінки 2C2P. За замовчуванням: English.

Options: English, Thai, Japanese, Bahasa Indonesia, Burmese, Simplified Chinese.

Redirect API version: залиште 8.5, якщо 2C2P не повідомила, що ваш обліковий запис досі використовує стару версію 7.0 (підписи SHA-1). Результати платежів, розпочатих до перемикання, усе одно перевіряються.

8.5 — HMAC-SHA256 (recommended): поточна версія (за замовчуванням).

7.0 — HMAC-SHA1 (legacy accounts): для старіших облікових записів 2C2P.

Order ID prefix: необов'язковий, лише літери та цифри (до 10 символів), наприклад SHOP1. 2C2P не приймає ID замовлення, який уже був використаний. Задайте унікальний префікс, якщо кілька магазинів використовують один обліковий запис 2C2P, а також у тестовому середовищі, де тестові облікові записи мерчантів спільні. Інші символи видаляються під час збереження, з попередженням.

Розширені налаштування

Enable Logging: Log 2C2P events записує події до WooCommerce > Status > Logs, джерело wcp_2c2p_payment. Дані карток і секретні ключі не записуються. За замовчуванням: вимкнено.

Delete Data on Uninstall: Delete the gateway settings, 2C2P order meta and log files when the plugin is deleted. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням 2C2P Payment) і оформлює замовлення. Наступна сторінка показує Thank you for your order. You will be redirected to 2C2P to complete your payment. і через мить перенаправляє покупця на платіжну сторінку 2C2P. Якщо цього не сталося, покупець натискає Pay via 2C2P. На сторінці також є кнопка Cancel order.

На платіжній сторінці 2C2P покупець платить будь-яким способом, увімкненим у вашому обліковому записі 2C2P, наприклад картками, електронними гаманцями, QR-платежами, інтернет-банкінгом або готівкою. Плагін передає суму замовлення у валюті замовлення, e-mail для рахунку покупця та назви замовлених товарів. Платіж можна завершити протягом 24 годин.

2C2P повідомляє про результат двічі: браузер покупця повертається до магазину, а 2C2P надсилає серверне сповіщення. Обидва варіанти обробляються однаково. Замовлення позначається оплаченим лише після того, як 2C2P підтвердить його дійсним підписом. Результат також має належати цьому замовленню: перевіряються ID мерчанта, ключ замовлення (order key), ID замовлення та спосіб оплати. Результати без дійсного підпису відхиляються.

Після успішного або очікуваного платежу покупець потрапляє на сторінку підтвердження замовлення, а кошик очищується. Якщо платіж не завершено, покупець повертається до оформлення замовлення з повідомленням Payment was not completed. Please try again or choose a different payment method. Замовлення скасовується, кошик зберігається, і покупець оформлює нове замовлення. Якщо результат неможливо підтвердити, покупець бачить We could not confirm the payment result. If your account was charged, please contact us before paying again.

Спосіб оплати працює в класичному оформленні замовлення та в блоці Checkout. Він сумісний із WooCommerce High-Performance Order Storage (HPOS).

Плагін не здійснює повернення коштів з WooCommerce, не зберігає картки, не підтримує регулярні платежі чи WooCommerce Subscriptions, не має полів для карток на вашому сайті та не підтримує API 2C2P PGW 4.x.

Замовлення

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

Pending payment: покупця перенаправлено на 2C2P, а результат ще не надійшов.

Processing or Completed: 2C2P повідомив про успішний платіж (статус 000). WooCommerce встановлює Processing або Completed для замовлень, що містять лише віртуальні товари для завантаження. Примітка до замовлення показує транзакцію 2C2P, код схвалення, дату та канал оплати. ID транзакції — це довідковий номер транзакції 2C2P.

On hold: платіж очікує в 2C2P (статус 001), наприклад готівковий платіж, який покупець ще не сплатив. Замовлення стає оплаченим, коли 2C2P повідомляє про платіж. Замовлення також переходить у статус On hold, якщо 2C2P повідомляє іншу суму або валюту, ніж сума замовлення. Примітка до замовлення показує отримані та очікувані значення. Перевірте замовлення та транзакцію в порталі 2C2P.

Cancelled: платіж відхилено, скасовано покупцем або він не пройшов (статуси 002, 003, 999). Примітка до замовлення показує статус і причину.

Оплачене або повернене замовлення ніколи не змінюється пізнішим результатом, а повторний старий результат не відкриває знову замовлення, яке ви скасували.

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

Повернення коштів з WooCommerce не підтримується. Поверніть платіж у порталі мерчанта 2C2P, а потім створіть повернення вручну в WooCommerce.

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

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

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

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

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

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

2C2P не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, а для поточного режиму заповнені Merchant ID і Secret Key: поля sandbox у тестовому режимі, поля робочого режиму в робочому. Перевірте, що валюта магазину підтримується. У обох випадках сторінка налаштувань показує попередження.

Платіж пройшов, але замовлення залишається Pending payment: дійсний результат не надійшов до вашого магазину. Перевірте, що Merchant ID і Secret Key поточного режиму відповідають обліковому запису 2C2P, через який здійснено платіж, і що Redirect API version відповідає вашому обліковому запису. Результат з неправильним підписом або для іншого Merchant ID відхиляється. Увімкніть Enable Logging і знайдіть повідомлення про хеш або Merchant ID у WooCommerce > Status > Logs. Також перевірте, що ваш сервер приймає запити від 2C2P на адресу серверного сповіщення.

2C2P повідомляє, що ID замовлення вже існує: 2C2P не приймає однаковий ID замовлення двічі. Це трапляється, коли кілька магазинів використовують один обліковий запис 2C2P або в тестовому середовищі, де тестові облікові записи мерчантів спільні для багатьох розробників. Задайте унікальний Order ID prefix.

Платіж здійснено, але замовлення в статусі On hold: або платіж ще очікує в 2C2P (наприклад, готівковий платіж, який покупець ще не сплатив), або сплачена сума чи валюта не збіглися із замовленням. Перевірте примітки до замовлення та транзакцію в порталі 2C2P.

Покупець бачить повідомлення This payment method is currently unavailable for this order. Так буває, коли валюта замовлення не підтримується або Merchant ID чи Secret Key поточного режиму порожні.

Повідомлення Please enter your live Merchant ID or Please enter your live Secret Key on save: з'являється, коли режим sandbox вимкнено, а поле робочого режиму порожнє. Введіть робочі облікові дані або залиште Sandbox Mode увімкненим.

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

Видалення

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

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