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

Вимоги

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

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

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

Валюта магазину: японська єна (JPY). За іншої валюти магазину спосіб оплати приховується під час оформлення замовлення. На сторінці Pay for order враховується валюта замовлення.

Обліковий запис GMO Payment Gateway: договір мерчанта GMO-PG з Link Type Plus. Потрібні Shop ID, Shop password і Config ID Link Type Plus (設定ID) тестового та/або робочого середовища, а також увімкнене сповіщення про результат (結果通知) у консолі магазину GMO-PG (див. «Налаштування»). Site ID та Site password не використовуються.

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

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

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

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

3. Відкрийте налаштування: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card > Manage або натисніть Settings під назвою плагіна на сторінці плагінів.

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

5. Введіть Shop ID, Shop password і Config ID тестового та/або робочого середовища й виберіть Environment.

6. У консолі магазину GMO-PG увімкніть 結果通知 (сповіщення про результат) і задайте URL сповіщень із налаштувань (див. «Налаштування»).

7. Увімкніть Enable/Disable. Виконайте тестовий платіж у тестовому середовищі, потім перемкніть Environment на робоче середовище.

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

Усі налаштування розміщено на одній сторінці: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card. Заголовок сторінки показує позначку TEST або PRODUCTION для поточного середовища. Над полями з’являються попередження, якщо валюта магазину не JPY або не заповнено Shop ID, Shop password чи Config ID поточного середовища. В обох випадках спосіб оплати приховується під час оформлення замовлення. У списку способів оплати шлюз позначено як такий, що потребує налаштування, доки не задано облікові дані поточного середовища. Під час збереження пробіли на початку та в кінці облікових даних видаляються.

Enable/Disable: Enable GMO Payment Gateway — Credit Card вмикає або вимикає спосіб оплати. Типово: вимкнено.

Title: назва способу оплати під час оформлення замовлення. Типово: Credit card.

Description: текст під способом оплати під час оформлення замовлення. Типово: You will be redirected to the secure GMO Payment Gateway page to pay by credit card.

Обліковий запис GMO-PG

Shop ID і Shop password розміщено в консолі магазину GMO-PG у Shop management > Shop information, Config ID — у Link Type Plus > Settings (設定ID). Тестове й робоче середовища мають різні облікові дані.

Environment: середовище GMO-PG, що приймає платежі.

Облікові дані робочого середовища (p01.mul-pay.jp)

Production Shop ID: Shop ID робочого середовища.

Production Shop password: Shop password робочого середовища.

Production Config ID: ідентифікатор конфігурації Link Type Plus (設定ID), зареєстрований у консолі GMO-PG.

Облікові дані тестового середовища (pt01.mul-pay.jp)

Test Shop ID: Shop ID тестового середовища.

Test Shop password: Shop password тестового середовища.

Test Config ID: ідентифікатор конфігурації Link Type Plus (設定ID) тестового середовища.

Оплата

Capture: коли списуються кошти з картки.

Order status after payment: статус оплаченого замовлення. Встановлюється одразу, з однією зміною статусу й одним листом покупцю.

Сповіщення про оплату (結果通知)

Сповіщення про результат повідомляє магазину про здійснений платіж. Воно обов’язкове. У консолі магазину GMO-PG увімкніть 結果通知 (сповіщення про результат) і задайте URL сповіщень із цього розділу налаштувань. Він має приблизно такий вигляд: https://your-site/wc-api/gmo_pg_webhook/. Скопіюйте URL точно так, як показано в налаштуваннях.

Сповіщення GMO-PG не підписані, тому плагін ніколи не довіряє їхньому вмісту. Сповіщення має надходити від одного з налаштованих Shop ID і стосуватися платежу, створеного цим магазином у тому середовищі, де оплачено замовлення. Потім плагін запитує транзакцію в GMO-PG (SearchTrade) з вашим Shop password і змінює замовлення лише на основі цієї відповіді. Сповіщення без відповідної реальної транзакції нічого не змінює. Отримання транзакцій, створених поза магазином, наприклад у консолі GMO-PG, підтверджується, але самі транзакції ігноруються. Якщо плагін не може перевірити сповіщення, він відповідає так, щоб GMO-PG надіслав його повторно (GMO-PG робить до 5 повторних спроб).

Без сповіщення замовлення підтверджується лише після повернення покупця до магазину після оплати.

Додатково

Debug log: Log API requests and notifications записує їх до WooCommerce > Status > Logs, джерело wcp_gmo_payment. Помилки реєструються завжди. Паролі й дані покупців маскуються. Типово: вимкнено.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. Деактивація ніколи нічого не видаляє. Дані замовлень (ідентифікатори транзакцій) завжди зберігаються. Типово: вимкнено.

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

Покупець вибирає спосіб оплати (типово Credit card) і оформлює замовлення. Плагін створює платіж GMO-PG Link Type Plus на суму замовлення, округлену до цілих єн, і спрямовує покупця на платіжну сторінку GMO-PG. Там покупець платить кредитною карткою. Перевірку 3-D Secure 2.0 виконує GMO-PG, якому для 3-D Secure передається e-mail покупця з платіжних даних. Сторінка оплати відкривається японською, китайською або англійською залежно від мови сайту. У GMO-PG платіж показується з WC- і номером замовлення. Інші дані покупця не передаються.

Після оплати покупець повертається до магазину. Підписаний результат перевіряється з вашим Shop password, а замовлення позначається оплаченим лише після підтвердження GMO-PG: серверним запитом SearchTrade під час повернення покупця або сповіщенням про результат. Обидва шляхи використовують однакову логіку, тому замовлення ніколи не обробляється двічі. Якщо платіж ще не підтверджено, сторінка отриманого замовлення показує Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed.

Якщо картку відхилено або платіж на сторінці GMO-PG не вдався, замовлення отримує статус «Невдале», а покупець переходить на сторінку Pay for order з повідомленням The card payment was declined or could not be completed. Please try again or use another card. Якщо покупець залишає сторінку GMO-PG без оплати, та сама сторінка показує The payment was not completed. You can try again or choose another payment method. Кожна нова спроба скасовує попереднє неоплачене платіжне посилання. Якщо за попереднім посиланням за цей час уже сплатили, враховується цей платіж, а нове посилання не створюється.

Можна оплатити замовлення на суму від 1 до 9 999 999 JPY. За більшої суми спосіб оплати приховується. Якщо почати платіж не вдається, покупець бачить коротке повідомлення, наприклад Card payment could not be started. Please try again or choose another payment method., а причина додається до приміток замовлення.

Спосіб оплати працює в класичному оформленні замовлення, у блоках «Кошик» і «Оформлення замовлення» та на сторінці Pay for order. У блоці «Оформлення замовлення» показуються значок картки й опис. У тестовому середовищі класичне оформлення та блок «Оформлення замовлення» показують позначку Test mode — no real charge. Підтримується високопродуктивне сховище замовлень WooCommerce (HPOS).

Плагін приймає оплату кредитними картками лише в JPY і завжди на сторінці GMO-PG. Інші способи оплати GMO-PG, кілька валют, збережені картки, реєстрація учасників GMO-PG, підписки, регулярні списання й форма картки на сайті не підтримуються.

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

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

Pending payment: покупець перейшов до GMO-PG і ще не сплатив або GMO-PG ще не підтвердив платіж.

Processing or Completed: платіж підтверджено. Статус визначається налаштуванням Order status after payment. Примітка замовлення показує суму, статус GMO-PG, транзакцію та спосіб підтвердження (сповіщення або повернення покупця). Ідентифікатор транзакції — GMO-PG TranID.

On hold (authorized): за Authorize only (仮売上) суму авторизовано. Спишіть її дією замовлення Capture payment (GMO-PG) або в консолі GMO-PG до завершення строку авторизації. Після списання замовлення отримує статус «Обробляється» або «Виконано». Якщо авторизацію скасовано в GMO-PG, замовлення скасовується.

On hold after payment: GMO-PG повідомив суму, відмінну від суми замовлення, або платіж надійшов після скасування замовлення. Подробиці наведено в примітці замовлення. Перевірте замовлення й виконайте його або поверніть платіж.

Failed: картку відхилено або платіж на сторінці GMO-PG не завершено.

Якщо надходить другий платіж за вже оплаченим або закритим замовленням, замовлення не змінюється. Примітка пропонує повернути повторний платіж у консолі GMO-PG.

Списання

Дія замовлення Capture payment (GMO-PG) з’являється в замовленнях «На утриманні», які лише авторизовано. Вона списує авторизовану суму. Якщо транзакція більше не авторизована, наприклад уже списана в консолі GMO-PG, дія додає примітку з поточним статусом і діє відповідно до нього.

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

Відкрийте замовлення, натисніть Refund, введіть суму й натисніть Refund via Credit card (кнопка показує ваш Title). Підтримуються повні й часткові повернення в цілих єнах. Повернення всієї залишкової суми скасовує транзакцію GMO-PG, а GMO-PG визначає, чи буде це анулювання або повернення. Часткове повернення зменшує суму транзакції, і карткова компанія авторизує нову суму. Повернення надсилається в те середовище, де оплачено замовлення, тому мають бути задані його Shop ID і Shop password. Якщо GMO-PG не приймає повернення, WooCommerce показує помилку, а повернення не реєструється. Успішне повернення додається до приміток замовлення.

Повернення та скасування з консолі GMO-PG надходять через сповіщення про результат і додаються до приміток замовлення. Вони не реєструються автоматично як повернення WooCommerce. За потреби створіть повернення вручну у WooCommerce без кнопки GMO-PG.

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

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

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

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

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

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

Кредитна картка не з’являється під час оформлення замовлення: перевірте активність ліцензії, увімкнення Enable/Disable, валюту магазину JPY і наявність Shop ID, Shop password та Config ID поточного середовища. Замовлення дорожчі за 9 999 999 JPY не можна оплатити карткою. Сторінка налаштувань попереджає про неправильну валюту або облікові дані.

Платіж пройшов, але замовлення залишається Pending payment: сповіщення про результат не працює. У консолі магазину GMO-PG використовуваного середовища перевірте, чи ввімкнено 結果通知 і чи URL точно збігається з указаним у налаштуваннях. Перевірте заповнення Shop ID і Shop password цього середовища: плагін використовує їх для перевірки кожного сповіщення. Увімкніть Debug log і відкрийте WooCommerce > Status > Logs, джерело wcp_gmo_payment. Замовлення також підтверджується після повернення покупця до магазину після оплати.

У журналі Notification rejected: unknown ShopID: сповіщення надійшло від магазину, чий Shop ID відсутній у налаштуваннях. Введіть Shop ID цього середовища.

У журналі Notification ignored ... is not a payment of this store: транзакцію створено поза цим магазином, наприклад у консолі GMO-PG. Нічого робити не потрібно.

Журнал повідомляє про оплату замовлення в іншому середовищі: тестові та робочі платежі розділено. Тестове сповіщення ніколи не підтверджує замовлення робочого середовища, і навпаки.

Покупець бачить помилку під час оформлення замовлення: відкрийте примітки замовлення або ввімкніть Debug log. У примітці вказано код помилки GMO-PG (ErrCode, ErrInfo). Зазвичай причина в неправильних Shop ID, Shop password або Config ID. GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. означає, що валюта замовлення не JPY.

Після оплати замовлення має статус On hold: прочитайте примітку замовлення. Замовлення лише авторизовано й очікує списання, сплачена сума відрізнялася від суми замовлення або платіж надійшов після скасування замовлення.

Повернення не вдається: прочитайте повідомлення. Можливо, замовлення оплачено в іншому середовищі, для якого не задано Shop ID і пароль, транзакцію вже скасовано в GMO-PG або сума перевищує залишок транзакції.

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

Видалення

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

GMO Payment Gateway є торговельною маркою відповідного власника. Цей плагін не пов’язаний з GMO Payment Gateway і не схвалений GMO Payment Gateway.