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. з посиланням назад до магазину.

Залишки товарів зменшуються, коли оплату підтверджено, а не коли покупця перенаправлено. Спосіб оплати працює в класичному оформленні замовлення, у блоці Checkout і на сторінці 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.