VibeFox iPay88 for WooCommerce — Помощь

Требования

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

WooCommerce: 7.0 или новее, установлен и активен. Без WooCommerce плагин не активируется.

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

Учётная запись мерчанта iPay88: Merchant Code и Merchant Key выдаёт iPay88 после активации вашей учётной записи мерчанта. Они также отображаются в портале мерчанта iPay88. Если вы ещё не мерчант, подайте заявку на сайте iPay88. Храните Merchant Key в секрете: им подписываются платежи.

Request URL: адрес вашего сайта должен быть зарегистрирован в iPay88 как Request URL. Иначе на странице iPay88 появится сообщение «Permission not allow».

Валюта магазина: Malaysia — MYR, а также USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP или THB, если на вашем аккаунте iPay88 включена опция мультивалютности; Philippines — PHP или USD; Indonesia — IDR; Thailand — THB.

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

Установка

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

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Payments > iPay88 > Manage или нажмите Settings под названием плагина на странице Plugins.

4. Введите лицензионный ключ VibeFox в блоке лицензии в верхней части страницы и нажмите Activate.

5. Выберите iPay88 region и введите Merchant Code и Merchant Key (см. раздел Настройка).

6. Включите Enable/Disable. Чтобы проверить настройку, выполните платёж при включённом Test mode, а затем выключите тестовый режим.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > iPay88. Над полями страница предупреждает, если не указан Merchant Code или Merchant Key (тогда способ оплаты не показывается при оформлении заказа), если валюта магазина не может быть списана в выбранном регионе, а также пока включён тестовый режим. В списке способов оплаты iPay88 помечен как требующий настройки, пока не введены оба ключа, и показывает метку тестового режима, пока он включён.

Общие

Enable/Disable: Enable iPay88 Payment Gateway включает или выключает способ оплаты. По умолчанию: выключено.

Title: название способа оплаты, которое видит покупатель при оформлении заказа. По умолчанию: iPay88.

Description: текст, который показывается под способом оплаты при оформлении заказа. По умолчанию: Pay securely via iPay88 (credit card, online banking, e-wallet).

Аккаунт iPay88

iPay88 region: страна вашей учётной записи мерчанта iPay88. От неё зависят страница оплаты iPay88 и валюты, которые можно списать. Заказ всегда списывается в собственной валюте. По умолчанию: Malaysia.

Malaysia (payment.ipay88.com.my): MYR и другие валюты из раздела «Требования», если на вашем аккаунте включена мультивалютность.

Philippines (payment.ipay88.com.ph): PHP, USD.

Indonesia (payment.ipay88.co.id): IDR, отправляется без десятичных знаков.

Thailand (payment.ipay88.co.th): THB.

Merchant Code: ваш Merchant Code iPay88, например M01234.

Merchant Key: ваш Merchant Key iPay88. Им подписываются запросы на оплату и проверяются ответы iPay88. Храните его в секрете.

Signature type: способ подписи запросов на оплату. Ответы проверяются в обоих форматах.

SHA256 (recommended): актуальная спецификация iPay88 (по умолчанию).

SHA1 (legacy): выбирайте, только если iPay88 попросил использовать устаревшую подпись.

Оплата

Payment method: выберите один способ оплаты iPay88 из списка PaymentId для Malaysia или оставьте Let the customer choose on the iPay88 page (по умолчанию). В список входят Credit Card (MYR), FPX (Online Banking), Maybank2U, Alliance Online, AmBank, RHB Bank, Hong Leong Bank, CIMB Clicks, Web Cash, PayPal (MYR), Credit Card (PHP), Boost, Touch n Go eWallet, GrabPay и ShopeePay.

Reference prefix: необязательно. Добавляется перед номером заказа в ссылке iPay88 (RefNo), например SHOP1-. Используйте разный префикс в каждом магазине, который работает с одним аккаунтом iPay88, чтобы ответ одного магазина никогда не был применён к заказу другого. Допускаются буквы, цифры, «-» и «_», до 10 символов. Префикс, оканчивающийся цифрой, исправляется при сохранении, потому что номер заказа читается с конца ссылки.

Test mode: Charge a fixed test amount instead of the order total. У iPay88 нет отдельной песочницы: тестовые платежи — это реальные транзакции на боевой странице iPay88 на небольшую сумму (1,00; IDR 10 000). После получения тестовой суммы заказ отмечается оплаченным, и это указывается в примечании к заказу. Пока тестовый режим включён, при оформлении заказа показывается TEST MODE: only a test amount of ... will be charged. Никогда не оставляйте тестовый режим включённым в работающем магазине. По умолчанию: выключено.

URL ответа и backend

Плагин передаёт оба URL с каждым платежом, поэтому ничего настраивать не нужно. Если iPay88 запросит их, скопируйте из этого раздела настроек. Они выглядят так: https://your-site/wc-api/ipay88_p_response/ (Response URL, возврат покупателя) и https://your-site/wc-api/ipay88_p_backend/ (Backend URL, серверное уведомление). В разделе также указан адрес вашего сайта, который должен быть зарегистрирован в iPay88 как Request URL.

Оба ответа iPay88 проверяются одинаково: подпись, рассчитанная с вашим Merchant Key, ссылка на платёж, который этот магазин начал для данного заказа, сумма и валюта. Запросы без корректной подписи отклоняются и никогда не меняют заказ. Уведомление backend получает ответ RECEIVEOK только после обработки; иначе iPay88 отправит его повторно. iPay88 сообщает следующие статусы платежа:

1 (успех): платёж выполнен. Заказ отмечается оплаченным после проверки суммы и валюты.

6 (ожидание): платёж ещё ожидает, например перевод через банкомат или на виртуальный счёт. Заказ переводится на удержание, пока iPay88 не подтвердит или не отклонит платёж.

Любой другой статус: платёж не прошёл или был отменён. Заказ переходит в статус «Не удался» с причиной от iPay88.

Дополнительно

Debug log: Log payment requests and iPay88 responses в WooCommerce > Status > Logs, источник wcp_ipay88_payment, без персональных данных и подписей. Ошибки записываются всегда. По умолчанию: выключено.

Delete data on uninstall: Delete the settings, logs and iPay88 order data when the plugin is deleted. Сами заказы никогда не удаляются. По умолчанию: выключено.

Оформление заказа

Покупатель выбирает способ оплаты (по умолчанию iPay88) и оформляет заказ. Заказ остаётся в статусе Pending payment, а покупатель видит Redirecting to iPay88 payment gateway..., пока форма отправляется на страницу оплаты iPay88 вашего региона. Без JavaScript покупатель нажимает Pay Now. Позиции заказа, имя, e-mail и телефон покупателя передаются в iPay88. На странице iPay88 покупатель платит картой, через FPX (интернет-банкинг), электронный кошелёк или другой способ, который доступен в вашем аккаунте.

После оплаты покупатель возвращается на страницу «Заказ получен» вашего магазина. Заказ отмечается оплаченным только после того, как iPay88 подтвердит оплату подписанным ответом: либо при возврате покупателя, либо через уведомление backend. Если подтверждение ещё не пришло, страница показывает We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. Для платежа в ожидании она показывает Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed.

Если платёж не прошёл или был отменён, покупатель попадает на страницу Pay for order с сообщением The payment was not completed: и причиной от iPay88, и может оплатить снова или выбрать другой способ оплаты. Если ответ не удаётся проверить, покупатель видит The payment response could not be verified. If you completed the payment, please contact us with your order number — the payment will be checked manually. со ссылкой на магазин.

Остатки уменьшаются, когда оплата подтверждена, а не когда покупатель перенаправлен. Способ оплаты работает в классическом оформлении заказа, в блоке «Оформление заказа» и на странице Pay for order. Он совместим с WooCommerce High-Performance Order Storage (HPOS).

Плагин принимает только разовые платежи. Он не поддерживает возвраты из WooCommerce, сохранённые карты, подписки, предавторизацию и списание или поля карты на вашем сайте. Он не запрашивает у iPay88 статус платежа повторно: заказы обновляются только по ответу iPay88 и уведомлению backend. API 2.0 для iPay88 Indonesia (JSON / ссылка на оплату) не используется.

Заказы

Order statuses

Pending payment: покупатель был направлен в iPay88 и ещё не оплатил или iPay88 ещё не подтвердил платёж.

Processing or Completed: платёж подтверждён. WooCommerce присваивает обычный статус для оплаченного заказа. Примечание к заказу показывает TransID, PaymentID, сумму и валюту iPay88. Идентификатор транзакции — это TransID iPay88. В тестовом режиме второе примечание сообщает, что вместо суммы заказа списана тестовая сумма.

On hold, pending at iPay88: iPay88 сообщил, что платёж ожидает. Заказ будет обновлён, когда iPay88 подтвердит или отклонит платёж.

On hold, for review: iPay88 сообщил об успешном платеже с суммой или валютой, отличными от заказа, либо платёж поступил после отмены заказа. Заказ не был отмечен оплаченным. Причина указана в примечании к заказу. Проверьте платёж в портале iPay88, затем выполните заказ или сделайте возврат.

Failed: платёж не прошёл или был отменён. Примечание показывает причину от iPay88. Покупатель может оплатить снова.

Если для заказа, который уже оплачен или возвращён, поступает ещё один успешный платёж, заказ не меняется. Примечание просит проверить его в портале iPay88 и вернуть деньги, если это дубликат. Неудачный ответ никогда не меняет оплаченный, возвращённый или отменённый заказ.

Возвраты

Возвраты из WooCommerce в iPay88 не отправляются. Верните платёж в портале мерчанта iPay88, а возврат зафиксируйте в WooCommerce вручную.

Лицензионный ключ

Плагин работает с лицензионным ключом VibeFox, полученным на vibefox.net. Блок лицензии находится в верхней части раздела WooCommerce > Settings > Payments > iPay88. Вставьте ключ в поле License key и нажмите Activate. В блоке показан статус, например дата, до которой действует лицензия, и ваш домен. Кнопкой Check now можно повторно проверить статус, Change key позволяет ввести другой ключ, а Remove key удаляет ключ с этого сайта. Ссылка Manage licenses and domains in your account открывает ваш аккаунт на vibefox.net.

Один ключ работает на одном домене. Удаление ключа с сайта не освобождает место под домен. Освободите его в вашем аккаунте на vibefox.net.

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

Когда лицензия истекает, плагин продолжает работать, но для обновлений и поддержки нужно продление. Статус автоматически проверяется снова в фоновом режиме.

Устранение неполадок

iPay88 не появляется при оформлении заказа: проверьте, что лицензия активна, включён Enable/Disable, введены Merchant Code и Merchant Key, а валюта магазина может быть списана в выбранном iPay88 region. Страница настроек показывает предупреждение, если чего-то не хватает.

Платёж прошёл, но заказ остаётся в статусе Pending payment: ни возврат покупателя, ни уведомление backend не дошли до вашего магазина с корректной подписью. Включите Debug log и посмотрите WooCommerce > Status > Logs, источник wcp_ipay88_payment. Убедитесь, что Merchant Key в точности совпадает с выданным iPay88, и что ваш сайт может принимать запросы от iPay88 по Backend URL, указанному в настройках.

Страница iPay88 показывает «Permission not allow»: адрес вашего сайта не зарегистрирован в iPay88 как Request URL. Попросите iPay88 зарегистрировать адрес, указанный в разделе Response and backend URLs.

Уведомление backend отвечает BAD SIGNATURE: подпись не совпадает с Merchant Key. Проверьте Merchant Key.

Уведомление backend отвечает NOT CONFIGURED: не задан Merchant Code или Merchant Key, поэтому ответ невозможно проверить. iPay88 отправит уведомление повторно.

Уведомление backend отвечает UNKNOWN ORDER: для этой ссылки в данном магазине не был начат платёж iPay88, например потому, что другой магазин с тем же аккаунтом не использует Reference prefix или использует тот же префикс.

Заказ в статусе On hold с примечанием о сумме или валюте: iPay88 сообщил о платеже, который не соответствует заказу, или заказ был отменён. Заказ не был отмечен оплаченным. Проверьте платёж в портале iPay88 и завершите его или сделайте возврат.

Покупатель видит «iPay88 cannot accept payments in» и валюту: валюта заказа не может быть списана в выбранном регионе. В iPay88 Malaysia валюты, отличные от MYR, также требуют опции мультивалютности на вашем аккаунте iPay88.

Реальные покупатели списываются только 1,00: включён Test mode. Выключите его.

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

Разработчики могут изменить URL страницы оплаты, валюты, количество десятичных знаков, тестовую сумму и значок с помощью фильтров ipay88_p_payment_url, ipay88_p_supported_currencies, ipay88_p_currency_decimals, ipay88_p_test_amount и ipay88_p_icon.

Удаление

Деактивация плагина сохраняет все данные. Чтобы удалить его, деактивируйте и удалите плагин на странице Plugins. Лицензионный ключ и статус лицензии этого плагина удаляются всегда. Настройки шлюза, журналы и данные iPay88, сохранённые в заказах, удаляются только если была включена опция Delete data on uninstall. В противном случае они сохраняются для повторной установки. Сами заказы никогда не удаляются и сохраняют примечания об оплате и идентификаторы транзакций.

iPay88 — товарный знак его правообладателя. Этот плагин не связан с iPay88 и не одобрен компанией iPay88.