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

iPay88 є товарним знаком його власника. Цей модуль не пов'язаний з iPay88 і не схвалений ним.