VibeFox 2C2P for WooCommerce — Помощь

Требования

WordPress: 5.8 или новее.

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

PHP: 8.0 или новее.

Учётная запись 2C2P: нужны Merchant ID и секретный ключ вашей учётной записи мерчанта 2C2P. Их выдаёт 2C2P при открытии учётной записи мерчанта. Тестовая среда и рабочая среда имеют разные ключи. Документация для разработчиков и тестовые карты для тестовой среды находятся на 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 и секретный ключ тестовой среды, включите Enable/Disable и оформите тестовый заказ.

6. Когда будете готовы, введите рабочие данные и снимите отметку Sandbox Mode.

Адреса возврата и уведомления передаются с каждым платежом. В портале 2C2P ничего настраивать не нужно.

Настройка

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

Общие

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: ваш секретный ключ тестовой среды 2C2P.

Учётные данные API для рабочей среды

Используются, когда тестовая среда выключена.

Merchant ID: ваш рабочий Merchant ID 2C2P. Обязателен, когда тестовая среда выключена.

Secret Key: ваш рабочий секретный ключ 2C2P. Обязателен, когда тестовая среда выключена. Ключ сохраняется точно так, как введён, включая кавычки и обратные слеши.

Страница оплаты

Этот раздел для справки показывает адрес возврата покупателя на сайт (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 подтвердит его действительной подписью. Результат также должен относиться к заказу: проверяются Merchant ID, ключ заказа, 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.

Способ оплаты работает в классическом оформлении заказа и в блоке «Оформление заказа». Он совместим с High-Performance Order Storage (HPOS) WooCommerce.

В плагине нет возвратов из WooCommerce, сохранённых карт, регулярных платежей и WooCommerce Subscriptions, полей для карт на вашем сайте, а также поддержки API 2C2P PGW 4.x.

Заказы

Статусы заказа

Pending payment: покупатель отправлен на 2C2P, и результат ещё не пришёл.

Processing или 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 и секретный ключ: тестовые поля в тестовом режиме, рабочие поля в рабочем режиме. Проверьте, что валюта магазина поддерживается. В обоих случаях страница настроек показывает предупреждение.

Оплата прошла, но заказ остаётся в статусе Pending payment: действительный результат не дошёл до магазина. Проверьте, что Merchant ID и секретный ключ текущего режима совпадают с учётной записью 2C2P, через которую прошла оплата, и что Redirect API version соответствует вашей учётной записи. Результат с неверной подписью или для другого Merchant ID отклоняется. Включите Enable Logging и найдите сообщения о hash или 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 или секретный ключ текущего режима пусты.

Please enter your live Merchant ID or Please enter your live Secret Key on save: тестовая среда выключена, а рабочее поле пусто. Введите рабочие данные или оставьте Sandbox Mode включённым.

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

Удаление

Деактивация плагина сохраняет все данные. Чтобы удалить плагин, деактивируйте его и удалите на странице Plugins. Лицензионный ключ и статус лицензии этого плагина всегда удаляются. Настройки платёжного шлюза, данные 2C2P, сохранённые в заказах, и файлы журналов удаляются, только если была включена опция Delete Data on Uninstall. Иначе они сохраняются для повторной установки. Существующие заказы сохраняют свои примечания об оплате и ID транзакций.

2C2P — товарный знак соответствующего правообладателя. Этот плагин не связан с 2C2P и не одобрен ею.