VibeFox iPay88 for PrestaShop — Помощь

Требования

PrestaShop: 8.0–9.x.

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

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

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. В панели администратора откройте Modules > Module Manager и нажмите Upload a module. Выберите ZIP-файл модуля.

2. Когда загрузка завершится, нажмите Configure или позже найдите VibeFox iPay88 Payment в списке модулей и нажмите Configure.

3. Введите лицензионный ключ VibeFox в поле License key в блоке лицензии вверху страницы Configure и нажмите Activate (см. Лицензионный ключ).

4. Выберите ваш iPay88 region, введите Merchant Code и Merchant Key, включите Enable/Disable и нажмите Save.

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

При установке модуль создаёт два статуса заказа: Awaiting iPay88 payment и iPay88 payment on hold. PrestaShop добавляет новый способ оплаты для всех валют, стран и групп клиентов. Ограничить их можно в разделе Payment > Preferences. Страну, которую вы включите после установки модуля, нужно также отметить для модуля в этом разделе, иначе клиенты из этой страны не увидят iPay88. URL ответа и backend передаются с каждым платежом.

Настройка

Все настройки находятся на странице модуля: Modules > Module Manager > VibeFox iPay88 Payment > Configure. Кнопка Save сохраняет всю страницу. Над полями страница показывает сообщение Введите Merchant Code и Merchant Key iPay88 — до этого способ оплаты не отображается на этапе оформления заказа., пока не заполнен ключ; предупреждение, если валюта по умолчанию магазина не может быть списана в выбранном регионе (тогда способ оплаты скрывается на этапе оформления заказа); и предупреждение, пока включён тестовый режим.

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

Clear saved secret: отметьте Merchant Key и нажмите Save, чтобы удалить сохранённый ключ. Пустое поле оставляет сохранённое значение.

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 символов. Прочие символы удаляются при сохранении, а префикс, оканчивающийся цифрой, получает «-» в конце, потому что номер корзины читается с конца RefNo. Страница затем показывает сохранённое значение. Если вы переходите с WooCommerce на PrestaShop с тем же аккаунтом iPay88, задайте префикс, чтобы новые ссылки никогда не повторяли старые номера заказов.

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

URL ответа и backend

Модуль передаёт оба URL с каждым платежом, поэтому их не нужно настраивать. Если iPay88 их запросит, скопируйте из этого раздела. С понятными URL они выглядят так: https://your-shop/module/wcp_ipay88_payment/response (Response URL, возврат покупателя) и https://your-shop/module/wcp_ipay88_payment/backend (Backend URL, серверное уведомление), возможно с кодом языка, например /en/. В этом разделе также указан адрес вашего сайта, который должен быть зарегистрирован в iPay88 как Request URL.

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

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

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

Any other status: платёж не прошёл или был отменён. Заказ не создаётся, а покупателю показывается причина от iPay88.

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

Debug log: записывает запросы на оплату и ответы iPay88 в файл logs/ipay88_p_debug.log.php в папке модуля. Файл нельзя открыть через веб. Персональные данные, Merchant Key и подписи не записываются. Ошибки и предупреждения записываются всегда, даже когда переключатель выключен. По умолчанию: выключено.

Log: показывает размер и последние записи журнала. Нажмите Clear log, чтобы очистить его.

Delete data on uninstall: удаляет настройки, журналы и платёжные данные iPay88 при удалении модуля. Заказы и статусы заказов никогда не удаляются. По умолчанию: выключено.

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

На этапе оплаты покупатель выбирает способ оплаты (по умолчанию iPay88) и подтверждает выбор. Следующая страница показывает Redirecting to iPay88 payment gateway... и Please do not close this window., пока форма отправляется на страницу оплаты iPay88 вашего региона. Без JavaScript покупатель нажимает Pay Now. На этом этапе заказа ещё нет. Модуль передаёт сумму корзины в валюте корзины (в тестовом режиме — тестовую сумму), названия товаров, имя, e-mail и телефон покупателя. На странице iPay88 покупатель платит картой, через FPX (интернет-банкинг), электронный кошелёк или другой способ, доступный в вашем аккаунте.

Заказ отмечается оплаченным только после того, как iPay88 подтвердит платёж подписанным ответом — либо при возврате покупателя, либо через уведомление backend. После успешного платежа заказ создаётся, и покупатель видит стандартную страницу подтверждения заказа с сообщением Your iPay88 payment has been received. Для платежа в ожидании страница показывает Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed. Для заказа на удержании — We have received a payment notification from iPay88 and are reviewing it. We will contact you if anything is needed. Если заказ в статусе Payment error или отменён, показывается The payment was not completed. Please contact us.

Если подтверждение в тот же момент обрабатывается уведомлением backend, покупатель видит We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. с кнопками Check again и Back to checkout.

Если платёж не прошёл или был отменён, заказ не создаётся и корзина сохраняется. Покупатель возвращается к оформлению заказа с сообщением The payment was not completed: и причиной от iPay88, после которого выводится You can try again or choose another payment method. Каждая попытка с той же корзиной использует тот же RefNo. Если ответ не удаётся проверить, покупатель видит 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. с кнопкой Return to the store.

Если платёж не удаётся начать, покупатель возвращается к оформлению заказа с сообщением This payment method is temporarily unavailable. Please choose another payment method. (не заполнены ключи или сумма равна нулю) либо iPay88 cannot accept payments in ... Please choose another payment method. (валюта не может быть списана в регионе). Если у корзины уже есть заказ (оплаченный или ожидающий платёж), вторая форма оплаты не создаётся, а покупатель переходит на страницу подтверждения заказа.

Модуль принимает только разовые платежи. Он не поддерживает возвраты из PrestaShop, сохранённые карты, подписки, предавторизацию и списание, а также поля карты на вашем сайте. Он не запрашивает статус платежа у iPay88 повторно: заказы обновляются только по ответу iPay88 и уведомлению backend.

Заказы

Order statuses

No order yet: покупатель был отправлен на iPay88, результат ещё не пришёл, либо платёж не прошёл. Существует только корзина.

Payment accepted: iPay88 сообщил об успешном платеже с ожидаемой суммой и валютой. Платёж записывается с TransId iPay88 в качестве ID транзакции. Внутреннее примечание показывает TransID, PaymentID, сумму и валюту. В тестовом режиме второе примечание сообщает, что списана тестовая сумма вместо суммы заказа.

Awaiting iPay88 payment: iPay88 сообщил о платеже как об ожидающем. Заказ переходит в статус Payment accepted, когда iPay88 подтверждает платёж, или в статус Payment error, если платёж не проходит.

Payment error: ожидавший платёж затем не прошёл. Примечание показывает причину от iPay88. У этой корзины уже есть заказ, поэтому покупатель не может оплатить его снова и оформляет новый заказ.

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

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

Блок оплаты iPay88

На странице заказа показывается блок iPay88 payment с RefNo, TransId, статусом, запрошенной суммой, полученной суммой, PaymentId, AuthCode, ошибкой и регионом, а также метка TEST MODE для тестовых платежей.

Возвраты

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

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

Модуль работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии License — VibeFox iPay88 Payment — это первый блок на странице Modules > Module Manager > VibeFox iPay88 Payment > Configure, над настройками. Введите ключ в поле License key и нажмите Activate. После этого блок показывает ключ в замаскированном виде, статус (например, дату, до которой лицензия действует, и ваш домен), а также кнопки Check now, чтобы проверить статус снова, Change key, чтобы ввести другой ключ, и Remove key, чтобы удалить ключ из этого магазина. Ниже находятся строка Product: presta-payment-ipay88 и ссылка Manage licenses and domains in your account, которая открывает вашу учётную запись vibefox.net. Изменить ключ могут только сотрудники с правом Configure для этого модуля. Тексты блока следуют языку бэк-офиса (включены английский и русский).

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

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

Без активного ключа iPay88 не показывается покупателям на этапе оформления заказа. Если платёж всё же начат, покупатель видит This payment method is not available. Please choose another one. Витрина PrestaShop не знает, что вы вошли в бэк-офис, поэтому способ оплаты скрыт и для вас: модуль можно настроить до покупки ключа, но протестировать его на этапе оформления заказа нельзя. Напоминание появляется в разделе Modules > Module Manager на вкладке Alerts. Существующие заказы не затрагиваются: уже начатые платежи по-прежнему подтверждаются.

Когда срок действия лицензии истекает, модуль продолжает работать, но обновления и поддержка требуют продления. Статус автоматически проверяется снова, пока вы работаете в бэк-офисе: раз в день в течение первых 14 дней после ввода ключа, затем раз в неделю. Cron-задание не нужно. Удаление или сброс модуля всегда удаляет лицензионный ключ и статус лицензии.

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

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

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

Уведомление backend отвечает RETRY: корзина в этот момент подтверждалась возвратом покупателя, либо заказ не удалось создать (например, модуль отключён). iPay88 отправит уведомление повторно.

Backend URL в браузере показывает BAD REQUEST: это нормально. URL принимает только подписанные запросы от iPay88.

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

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

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

Удаление

Перейдите в Modules > Module Manager, откройте меню рядом с VibeFox iPay88 Payment и выберите Uninstall. Лицензионный ключ и статус лицензии этого модуля всегда удаляются. В подтверждении сказано, что настройки и платёжные данные iPay88 сохраняются, если не включена опция Delete data on uninstall. Если она включена, удаляются настройки, журналы и платёжные данные iPay88. Если выключена, всё сохраняется для повторной установки. Статусы заказов Awaiting iPay88 payment и iPay88 payment on hold всегда сохраняются. Заказы никогда не удаляются и сохраняют свои платёжные примечания и ID транзакций.

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