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, которому передаётся e-mail покупателя из платёжных данных для 3-D Secure. Страница оплаты открывается на японском, китайском или английском языке в зависимости от языка сайта. В 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.