VibeFox ifthenpay for PrestaShop — Допомога

Вимоги

PrestaShop: 8.0 – 9.x.

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

Валюта: лише євро (EUR). Спосіб оплати приховано, якщо валюта кошика не EUR. ifthenpay приймає суми від 0,01 до 99 999,99 EUR.

Обліковий запис ifthenpay: зареєструйтеся на ifthenpay.com. Вам потрібен ключ способу, який ви пропонуєте: Multibanco, MB WAY або Credit Card (формат ABC-123456). Ключі показуються в бек-офісі ifthenpay (backoffice.ifthenpay.com) або надсилаються ifthenpay, коли спосіб активовано для вашого облікового запису. ifthenpay також має активувати callback для вашого ключа (див. Налаштування), а ваш магазин має бути доступний з інтернету.

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

Встановлення

1. У бек-офісі перейдіть до Modules > Module Manager і натисніть Upload a module. Оберіть ZIP-файл модуля.

2. Після завершення завантаження натисніть Configure або пізніше знайдіть VibeFox ifthenpay Gateway у списку модулів і натисніть Configure. Модуль створює свій антифішинговий ключ під час встановлення.

3. Введіть ліцензійний ключ VibeFox у поле License key блоку ліцензії вгорі сторінки Configure і натисніть Activate (див. Ліцензійний ключ).

4. Оберіть Payment Method, введіть для нього ключ ifthenpay і натисніть Save, щоб Callback URL відповідав обраному способу.

5. Скопіюйте Anti-phishing Key і Callback URL, показані в налаштуваннях, і попросіть ifthenpay активувати callback для вашого ключа (у бек-офісі або через підтримку ifthenpay).

6. Увімкніть Enable/Disable і натисніть Save.

Під час встановлення модуль створює два статуси замовлення: Awaiting ifthenpay payment і ifthenpay payment on hold. PrestaShop пропонує новий платіжний модуль для всіх валют, країн і груп клієнтів. Ви можете обмежити їх у Payment > Preferences; EUR має залишатися дозволеним.

Налаштування

Усі налаштування містяться на сторінці модуля: Modules > Module Manager > VibeFox ifthenpay Gateway > Configure. Кожен розділ із кнопкою Save зберігає всю сторінку. Без ключа обраного способу платіжний спосіб не показується на оформленні замовлення. Поки шлюз увімкнено без цього ключа, сторінка показує ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout.

ifthenpay

Enable/Disable: Enable ifthenpay Payment вмикає або вимикає платіжний спосіб. За замовчуванням: off.

Title: назва платіжного способу, яка показується на оформленні замовлення. Вона також зберігається в замовленні як назва способу оплати. За замовчуванням: ifthenpay.

Description: опис платіжного способу, який показується на оформленні замовлення. За замовчуванням: Pay via Multibanco, MB WAY or Credit Card. Змініть його відповідно до способу, який ви пропонуєте.

Payment Method: спосіб, який пропонується на оформленні замовлення. Обов'язковим є лише ключ цього способу.

Ключі ifthenpay

Ключі (формат ABC-123456) показуються в бек-офісі ifthenpay або надсилаються ifthenpay, коли платіжний спосіб активовано для вашого облікового запису.

Multibanco Key: ваш ключ ifthenpay Multibanco (MB) для динамічних референсів.

MB WAY Key: ваш ключ ifthenpay MB WAY.

Credit Card Key: ваш ключ ifthenpay Credit Card. Він також перевіряє підпис повернення клієнта зі сторінки карток.

Збережені ключі більше не показуються. Поле залишається порожнім і показує Saved — leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити.

Clear saved keys: позначте ключ і натисніть Save, щоб видалити його. Порожнє поле зберігає збережене значення.

Callback (повідомлення про оплату)

Callback повідомляє вашому магазину, що оплату здійснено. Попросіть ifthenpay активувати callback для кожного ключа, який ви використовуєте, з антифішинговим ключем і callback URL, наведеними нижче. Замовлення Multibanco та MB WAY підтверджуються лише callback; платежі карткою додатково підтверджуються підписаним поверненням зі сторінки карток.

Anti-phishing Key: створюється модулем і показується для копіювання. ifthenpay надсилає його назад у кожному callback; callback без нього відхиляються.

Callback URL: callback URL для обраного платіжного способу з плейсхолдерами ifthenpay, показаний для копіювання. З дружніми URL він починається так: https://your-shop/module/wcp_ifthenpay_gateway/callback, можливо з кодом мови, наприклад /en/, і далі йдуть параметри способу. Скопіюйте URL повністю, точно так, як він показаний у налаштуваннях.

Антифішинговий ключ у кожному callback порівнюється з вашим. Відсутній або неправильний ключ отримує відповідь 403, і замовлення не змінюється. Callback також має відповідати платежу цього модуля: для Multibanco — за організацією (entity) і референсом, для MB WAY — за кошиком і одним з його запитів MB WAY, для Credit Card — за кошиком і одним з його запитів за карткою. Без робочого callback замовлення Multibanco та MB WAY ніколи не підтверджуються, а платежі карткою підтверджуються лише підписаним поверненням. Callback працює, поки магазин перебуває в режимі обслуговування, і не блокується обмеженням за країнами вашого магазину.

Додатково

Test Mode: Credit Card і Multibanco використовують sandbox-адреси ifthenpay; реальні кошти не списуються, ви використовуєте тестові ключі, які надає ifthenpay. У MB WAY немає sandbox: перевіряйте його тестовим ключем від ifthenpay. На оформленні замовлення показується значок TEST MODE. За замовчуванням: off.

Order Status After Payment: статус замовлення, який встановлюється після підтвердженої оплати, з однією зміною статусу.

Debug Log: запити до API та callback записуються в logs/ifthenpay_p_debug.log.php у папці модуля. Файл не можна відкрити з веб. Помилки завжди записуються. Ключі, антифішинговий ключ і повні номери телефонів ніколи не записуються в журнал. За замовчуванням: off.

Log: показує розмір і останні записи журналу. Натисніть Clear log, щоб його очистити.

Delete Data on Uninstall: якщо увімкнено, під час видалення модуля видаляються його налаштування, антифішинговий ключ і журнал. Замовлення та записи платежів ifthenpay завжди зберігаються. За замовчуванням: off.

Оформлення замовлення

Multibanco. На оформленні замовлення покупець бачить You will receive a Multibanco reference to complete the payment. Коли покупець підтверджує, модуль створює динамічний референс Multibanco на суму кошика, і замовлення створюється в статусі Awaiting ifthenpay payment. На сторінці підтвердження замовлення показано Multibanco Payment Details: організація (entity), референс і сума, з текстом Please use these details to pay at any Multibanco ATM or through your online banking. Ті самі дані додаються до листа з підтвердженням замовлення. Замовлення оплачується, коли ifthenpay надсилає callback про оплату.

MB WAY. Покупець вводить MB WAY phone number (912 345 678, +351 912 345 678 або 351#912345678 для інших країн); телефон з адреси для рахунку заповнюється автоматично. Модуль надсилає запит на оплату на телефон, і замовлення створюється в статусі Awaiting ifthenpay payment. На сторінці підтвердження замовлення написано: A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. Замовлення оплачується, коли ifthenpay надсилає callback. Зберігається лише замаскований номер телефону.

Кредитна картка. Покупець бачить You will be redirected to a secure page to enter your card details. і перенаправляється на сторінку карток ifthenpay. Замовлення ще немає, кошик зберігається. Після успішної оплати покупець повертається до вашого магазину. Повернення приймається лише з дійсним підписом ifthenpay, захищеним ключем кошика, секретом цієї спроби та запитом за карткою для кошика; тоді замовлення створюється як оплачене, і покупець бачить стандартну сторінку підтвердження замовлення. Якщо повернення не вдається перевірити, нічого не змінюється, а сторінка Payment confirmation показує Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. з кнопкою Check again; callback створює замовлення, щойно він надійде. Якщо оплата карткою не вдалася або скасована, покупець повертається до оформлення замовлення з повідомленням The card payment was not completed. You can try again or choose another payment method. або The card payment was cancelled. You can try again or choose another payment method. Кожна спроба оплати карткою для кошика зберігається, тож платіж, зроблений у вкладці, відкритій раніше, також приймається.

Замовлення позначається оплаченим лише після підтвердження ifthenpay, а сума перевіряється до копійки щодо суми замовлення. Якщо оплату не вдається розпочати, покупець залишається на оформленні замовлення з коротким повідомленням, наприклад The Multibanco reference could not be created. Please try again or choose another payment method., The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method. або The payment service is temporarily unavailable. Please try again in a few minutes. Технічна причина записується в журнал.

Модуль пропонує один спосіб ifthenpay за раз. Він не підтримує Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX або Pay-by-Link, підписки та збережені картки, автоматичне закінчення строку дії або скасування неоплачених референсів Multibanco і опитування статусу платежу.

Замовлення

Статуси замовлення

No order yet: платіж карткою розпочато, але ще не підтверджено, або він не вдався чи був скасований. Існує лише кошик.

Awaiting ifthenpay payment: видано референс Multibanco або надіслано запит MB WAY. PrestaShop зменшує залишок товару під час створення замовлення. Неоплачені референси та відхилені запити MB WAY не скасовують замовлення автоматично; за потреби скасуйте такі замовлення самостійно.

Payment accepted or Delivered: оплату підтверджено. Статус відповідає Order Status After Payment. Платіж записується з референсом Multibanco, ID запиту MB WAY або ID запиту за карткою як ID транзакції, а примітка показує, як він був підтверджений.

ifthenpay payment on hold: отримана сума відрізнялася від суми замовлення (наприклад, кошик було змінено після початку платежу карткою), або платіж надійшов після скасування замовлення. Примітка це пояснює, і покупця не просять заплатити повторно. Перевірте платіж у бек-офісі ifthenpay і вручну завершіть або поверніть кошти за замовлення. Наступний правильний платіж за таким замовленням його не змінює.

Другий платіж за вже оплаченим замовленням лише додає примітку: перевірте в бек-офісі ifthenpay, чи це не дубльований платіж. Замовлення з поверненням коштів і замовлення, скасовані після оплати, ніколи не відкриваються знову.

Блок платежів ifthenpay

На сторінці замовлення показується блок ifthenpay payment зі спробами оплати замовлення (дата, спосіб, значок Sandbox для тестових платежів, сума, організація (entity) і референс Multibanco або замаскований номер MB WAY, ID запиту ifthenpay та статус), попередження Manual review, поки замовлення перебуває в статусі ifthenpay payment on hold, і ifthenpay notes замовлення.

Повернення коштів

Повернення коштів з PrestaShop не підтримуються. Оформіть повернення платежу в бек-офісі ifthenpay і вручну зафіксуйте його в PrestaShop. Callback про повернення (DEVOLVIDO) лише додає примітку. Інші статуси, які повідомляє ifthenpay, також лише додають примітку.

Ліцензійний ключ

Модуль працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox ifthenpay Gateway є першим блоком на сторінці Modules > Module Manager > VibeFox ifthenpay Gateway > Configure, над налаштуваннями. Введіть ключ у поле License key і натисніть Activate. Після цього блок показує ключ у замаскованому вигляді, статус (наприклад, дату, до якої ліцензія активна, і ваш домен) та кнопки Check now для повторної перевірки статусу, Change key для введення іншого ключа і Remove key для видалення ключа з цього магазину. Нижче розташовані рядок Product: presta-payment-ifthenpay і посилання 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.

Без активного ключа ifthenpay не показується клієнтам на оформленні замовлення. Якщо платіж все одно розпочато, клієнт бачить This payment method is not available. Please choose another one. Магазин PrestaShop не знає, що ви увійшли в бек-офіс, тож спосіб оплати приховано і для вас: модуль можна налаштувати до купівлі ключа, але не можна протестувати на оформленні замовлення. Нагадування з'являється в Modules > Module Manager на вкладці Alerts. Наявні замовлення не змінюються: платежі, які вже розпочато, усе одно підтверджуються.

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

Усунення несправностей

ifthenpay не з'являється на оформленні замовлення: перевірте, чи ліцензія активна, чи увімкнено Enable/Disable, чи заповнено ключ обраного Payment Method, чи валюта кошика EUR і чи сума від 0,01 до 99 999,99 EUR. У Payment > Preferences перевірте, чи дозволено модуль для EUR, країни клієнта та групи клієнта.

Клієнт заплатив, але замовлення залишилося в статусі Awaiting ifthenpay payment або замовлення не створено: callback не доходить до вашого магазину. Перевірте, чи ifthenpay активувала callback URL і антифішинговий ключ для ключа, який ви використовуєте, і чи URL відповідає обраному способу. Магазин має бути доступний з інтернету, а не на localhost і не за логіном. Шукайте рядки Callback rejected у полі Log на сторінці модуля.

Callback відповідає 403 Forbidden: антифішинговий ключ у callback відсутній або відрізняється від ключа в налаштуваннях. Надішліть ifthenpay ще раз ключ, показаний у налаштуваннях.

Callback відповідає 503 Not configured: антифішинговий ключ ще не створено. Відкрийте налаштування модуля один раз; ifthenpay повторить callback.

Callback відповідає 503 Busy: той самий кошик у цей момент оброблявся іншим запитом. ifthenpay повторить callback.

Callback відповідає Order not found: референс або запит не належить до платежу цього модуля, або кошик було оформлено з іншим способом оплати.

Чому оплачене замовлення перевели на утримання? Отримана сума відрізнялася від суми замовлення, або платіж надійшов після скасування замовлення. Прочитайте примітки в блоці ifthenpay payment, перевірте платіж у бек-офісі ifthenpay і вручну завершіть або поверніть кошти за замовлення.

Не вдалося надіслати запит MB WAY: номер телефону не прив'язано до MB WAY або він у неправильному форматі. Використовуйте 912 345 678 або 351#912345678 для номерів інших країн.

Тестовий режим і MB WAY: у ifthenpay немає sandbox для MB WAY; використовуйте тестовий ключ, наданий ifthenpay.

Видалення

Перейдіть до Modules > Module Manager, відкрийте меню поруч із VibeFox ifthenpay Gateway і виберіть Uninstall. Ліцензійний ключ і статус ліцензії цього модуля завжди видаляються. Якщо Delete Data on Uninstall увімкнено, налаштування модуля, антифішинговий ключ і журнал видаляються; після повторного встановлення створюється новий антифішинговий ключ, який треба знову надіслати ifthenpay. Якщо опцію вимкнено, усі налаштування зберігаються для подальшого повторного встановлення. Записи платежів ifthenpay (референси та ID запитів) і статуси замовлення Awaiting ifthenpay payment та ifthenpay payment on hold завжди зберігаються, тож callback за раніше виданими референсами знаходитимуть свої замовлення після повторного встановлення. Наявні замовлення зберігають свої примітки про оплату та ID транзакцій.

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