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

Вимоги

PrestaShop: 8.0–9.x.

PHP: 8.0 або новіша версія. Модуль не встановлюється на старіших версіях PHP.

Валюта: японська єна (JPY). GMO-PG проводить платежі лише в єнах, тому спосіб оплати показується лише тоді, коли валюта кошика — JPY. Додайте JPY у розділі International > Localization > Currencies, якщо її ще немає у вашому магазині.

Обліковий запис 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. У бек-офісі перейдіть до Modules > Module Manager і натисніть Upload a module. Оберіть ZIP-файл модуля.

2. Коли завантаження завершиться, натисніть Configure або пізніше знайдіть VibeFox GMO Payment Gateway у списку модулів і натисніть Configure.

3. Введіть ліцензійний ключ VibeFox у поле License key у блоці ліцензії вгорі сторінки Configure і натисніть Activate (див. розділ «Ліцензійний ключ»).

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

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

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

Під час встановлення модуль створює статус замовлення GMO-PG payment on hold. PrestaShop пропонує новий платіжний модуль для всіх валют, країн і груп клієнтів. Обмежити їх можна в розділі Payment > Preferences; JPY має лишатися дозволеною.

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

Усі налаштування розташовані на сторінці модуля: Modules > Module Manager > VibeFox GMO Payment Gateway > Configure. Кожна кнопка Save зберігає всю сторінку. Над полями сторінка попереджає, якщо валюта магазину за замовчуванням не JPY, і якщо бракує Shop ID, Shop password або Config ID поточного середовища (тоді спосіб оплати приховується на етапі оформлення замовлення). Вона також показує, яке середовище активне: TEST — payments go to pt01.mul-pay.jp with the test credentials, no real money is charged. або PRODUCTION — payments go to p01.mul-pay.jp. Пробіли навколо облікових даних видаляються під час збереження.

GMO Payment Gateway — Credit Card

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 приймає нові платежі.

Test (sandbox): pt01.mul-pay.jp з тестовими обліковими даними (за замовчуванням).

Production (live): p01.mul-pay.jp з робочими обліковими даними.

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

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

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

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

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

Test Config ID: config ID Link Type Plus (設定ID) тестового середовища.

Збережені паролі більше не відображаються. Поле лишається порожнім і показує Saved — leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити.

Clear saved passwords: позначте пароль і натисніть Save, щоб видалити його. Порожнє поле зберігає збережене значення.

Payment

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

Capture immediately (即時売上): кошти списуються одразу (за замовчуванням).

Authorize only (仮売上): сума лише авторизується, а замовлення переходить у статус GMO-PG payment on hold, доки ви не спишете її дією Capture payment (GMO-PG) на сторінці замовлення або в консолі GMO-PG, до закінчення строку авторизації.

Order status after payment: статус оплаченого замовлення.

Processing: замовлення отримує статус Payment accepted (за замовчуванням).

Completed: замовлення отримує статус Delivered. Підходить для віртуальних і цифрових товарів.

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

Сповіщення про результат повідомляє вашому магазину, що платіж здійснено. Воно обов’язкове. У консолі GMO-PG увімкніть 結果通知 (сповіщення про результат) і вкажіть URL, показаний у полі Notification URL цього розділу. За зрозумілих (людиночитних) URL він виглядає так: https://your-shop/module/wcp_gmo_payment/notify, можливо з кодом мови, наприклад /ja/. Скопіюйте URL точно так, як його показують налаштування. Він має бути доступний з Інтернету; режим обслуговування його не блокує.

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

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

Advanced

Debug log: записує запити до API та сповіщення у файл logs/gmo_pg_debug.log.php у папці модуля. Файл неможливо відкрити з веб-браузера. Помилки завжди записуються, навіть коли перемикач вимкнено. Паролі та дані покупців маскуються. За замовчуванням: вимкнено.

Log: показує розмір журналу та його останні записи. Натисніть Clear log, щоб очистити його.

Delete data on uninstall: якщо увімкнено, під час видалення модуля видаляються налаштування шлюзу та журнал. Дані замовлень (GMO OrderID, ID транзакцій) завжди зберігаються. За замовчуванням: вимкнено.

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

На етапі оплати покупець обирає спосіб оплати (за замовчуванням Credit card) і бачить його опис. У тестовому середовищі над ним відображається позначка TEST — GMO-PG test environment, no real charges.. Після підтвердження модуль створює платіж GMO-PG Link Type Plus на суму кошика, округлену до цілих єн, і надсилає покупця на платіжну сторінку GMO-PG. Там покупець платить кредитною карткою. 3-D Secure 2.0 обробляє GMO-PG, а e-mail покупця передається в GMO-PG для 3-D Secure. Платіжна сторінка відкривається японською, китайською або англійською мовою, залежно від мови покупця. У GMO-PG платіж відображається з префіксом PS- і номером кошика. Жодних інших даних покупця не передається. На цьому етапі замовлення ще не існує.

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

Якщо картку відхилено або платіж не пройшов на сторінці GMO-PG, покупець повертається до оформлення замовлення з повідомленням 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., а причина записується в журнал.

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

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

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

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

Замовлення ще немає: покупця було надіслано до GMO-PG, і він не сплатив, або GMO-PG ще не підтвердив платіж. Існує лише кошик.

Payment accepted або Delivered: платіж підтверджено. Статус відповідає налаштуванню Order status after payment. Платіж записується з TranID GMO-PG як ID транзакції, а примітка показує суму, статус GMO-PG, транзакцію та спосіб підтвердження (сповіщення або повернення).

GMO-PG payment on hold (авторизовано): за Authorize only (仮売上) суму авторизовано. Спишіть її дією Capture payment (GMO-PG) або в консолі GMO-PG до закінчення строку авторизації. Після списання замовлення переходить у статус Payment accepted або Delivered. Якщо авторизацію скасовано в GMO-PG, замовлення отримує статус Canceled.

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

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

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

Блок GMO Payment Gateway

На сторінці замовлення відображається блок GMO Payment Gateway з GMO OrderID, Transaction ID, статусом (зі статусом GMO-PG), Paid / refunded, позначкою TEST для тестових платежів, історією повернень і GMO-PG notes замовлення. Для списання та повернень потрібне право редагувати замовлення; доступ до сторінок модулів не потрібен.

Списання

Capture payment (GMO-PG) з’являється в блоці замовлення в очікуванні, яке було лише авторизоване. Підтвердьте Capture the authorized GMO-PG payment?. Модуль перевіряє транзакцію в GMO-PG і списує авторизовану суму. Якщо транзакція більше не авторизована, наприклад тому що її вже списано в консолі GMO-PG, примітка показує поточний статус, і замовлення йде за ним.

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

У блоці введіть суму (підставляється сума, ще не повернена), за бажання причину, і натисніть Refund via GMO-PG. Підтвердьте Refund this amount through GMO-PG?. Підтримуються повні та часткові повернення в цілих єнах. Ліміт — це сума, яку GMO-PG фактично списав і ще утримує, а не сума замовлення. Повернення всього залишку скасовує транзакцію GMO-PG, а рішення про те, це анулювання чи повернення, ухвалює GMO-PG. Часткове повернення зменшує суму транзакції. Повернення надсилається в те середовище, де було здійснено платіж, тому Shop ID і Shop password цього середовища мають бути заповнені. Якщо GMO-PG не приймає повернення, блок показує помилку, і жодне повернення не записується. Успішне повернення додається до історії повернень і приміток. Повне повернення встановлює статус замовлення Refunded; часткове повернення статус не змінює.

Модуль не створює кредитні ноти. Стандартні кнопки повернення PrestaShop на сторінці замовлення не повертають гроші через GMO-PG.

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

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

Модуль працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox GMO Payment Gateway — це перший блок на сторінці Modules > Module Manager > VibeFox GMO Payment Gateway > Configure, над налаштуваннями. Введіть ключ у поле License key і натисніть Activate. Після цього блок показує ключ приховано, статус (наприклад, дату, до якої ліцензія активна, і ваш домен) та кнопки Check now, щоб перевірити статус ще раз, Change key, щоб ввести інший ключ, і Remove key, щоб видалити ключ із цього магазину. Нижче розміщені рядок Product: presta-payment-gmo і посилання Manage licenses and domains in your account, яке відкриває ваш обліковий запис vibefox.net. Змінювати ключ можуть лише співробітники з правом Configure для модуля. Тексти блоку відповідають мові back office (включено англійську та російську).

Якщо ключ не прийнято, блок повідомляє причину, наприклад Key not found, This key belongs to another product, Domain limit reached або License expired on із датою. Після зміни адреси магазину або після звільнення слота домену у вашому обліковому записі натисніть Check now. Якщо сервер ліцензій недоступний, модуль продовжує працювати за останнім відомим статусом.

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

Без активного ключа оплата карткою GMO-PG покупцям на етапі оформлення замовлення не показується. Якщо платіж все одно розпочато, покупець бачить This payment method is not available. Please choose another one. Вітрина PrestaShop не знає, що ви ввійшли в back office, тож спосіб оплати приховується й для вас: модуль можна налаштувати до купівлі ключа, але протестувати його на етапі оформлення замовлення не можна. Нагадування з’являється в розділі Modules > Module Manager на вкладці Alerts. Існуючі замовлення не зачіпаються: платежі, які вже розпочато, і далі підтверджуються, а списання та повернення працюють.

Коли ліцензія спливає, модуль продовжує працювати, але оновлення та підтримка потребують продовження. Статус автоматично перевіряється знову, поки ви працюєте в back office: раз на день протягом перших 14 днів після введення ключа, потім раз на тиждень. Cron-завдання не потрібне. Видалення або скидання модуля завжди видаляє ліцензійний ключ і статус ліцензії.

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

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

Платіж пройшов, але замовлення не створено: сповіщення про результат не працює. У консолі магазину GMO-PG середовища, яким ви користуєтеся, перевірте, що 結果通知 увімкнено і що URL точно такий, як показано в полі Notification URL. Переконайтеся, що Shop ID і Shop password цього середовища заповнені, адже модуль перевіряє кожне сповіщення за ними. Увімкніть Debug log і подивіться поле Log на сторінці модуля. Замовлення також створюється, коли покупець повертається до магазину після оплати.

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

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

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

Журнал показує Cannot create the order: the module is disabled: модуль було вимкнено під час підтвердження платежу. Увімкніть його; GMO-PG надішле сповіщення повторно.

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

Замовлення має статус GMO-PG payment on hold: прочитайте примітки в блоці GMO Payment Gateway. Замовлення лише авторизоване і очікує списання, або сплачена сума відрізнялася від кошика.

Повернення або списання не вдається: прочитайте повідомлення в блоці. Замовлення могло бути оплачене в іншому середовищі, де не заповнені Shop ID і пароль; транзакцію могли вже скасувати в GMO-PG; або сума може перевищувати залишок за транзакцією. The order is being updated by GMO-PG right now. Try again in a moment. означає, що в цей самий час оброблялося сповіщення.

Блок показує You do not have permission to refund orders.: у вашому профілі співробітника немає права редагувати замовлення. Попросіть адміністратора надати його.

Видалення

Перейдіть до Modules > Module Manager, відкрийте меню поруч із VibeFox GMO Payment Gateway і виберіть Uninstall. Ліцензійний ключ і статус ліцензії цього модуля завжди видаляються. Якщо Delete data on uninstall увімкнено, налаштування шлюзу та журнал видаляються. Якщо вимкнено, усі налаштування зберігаються для майбутнього повторного встановлення. Транзакції та повернення GMO-PG і статус замовлення GMO-PG payment on hold завжди зберігаються, тож замовлення, оплачені раніше, можна списати та повернути й після повторного встановлення. Існуючі замовлення зберігають свої примітки про оплату та ID транзакцій.

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