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. В back office перейдите в 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 и не одобрен им.