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

Вимоги

PrestaShop: від 8.0 до 9.x.

PHP: 8.0 або новіша з розширеннями OpenSSL, DOM і SimpleXML. Без них модуль не встановлюється.

Валюта: валюта кошика має бути RON, EUR, USD або GBP. EUR, USD і GBP мають бути увімкнені у вашому обліковому записі Netopia. Для інших валют спосіб оплати приховується під час оформлення замовлення.

Обліковий запис Netopia: потрібен обліковий запис продавця Netopia Payments з точкою продажу. У його технічних налаштуваннях потрібні підпис облікового запису і, для кожного середовища, яке ви використовуєте (sandbox і робоче), відкритий сертифікат (.cer) і закритий ключ (.key). З боку Netopia нічого налаштовувати не потрібно: адреса IPN надсилається з кожним запитом на оплату.

Публічний магазин: URL IPN (підтвердження) має бути доступним з інтернету, а не за логіном чи базовою автентифікацією. Замовлення створюються лише за IPN від Netopia.

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

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

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

2. Після завершення завантаження натисніть Configure або пізніше знайдіть VibeFox Netopia Gateway у списку модулів і натисніть Configure.

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

4. В адмін-панелі Netopia відкрийте свою точку продажу, скопіюйте підпис облікового запису та завантажте сертифікат і закритий ключ для середовищ sandbox і робочого. Вставте підпис і повний вміст файлів у налаштування (див. Налаштування).

5. Увімкніть Enable/Disable і натисніть Save. Перевірте оплату в режимі sandbox, потім вимкніть Test mode, щоб приймати реальні платежі.

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

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

Усі налаштування розташовані на сторінці модуля: Modules > Module Manager > VibeFox Netopia Gateway > Configure. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Над полями сторінка попереджає, якщо відсутні підпис облікового запису, сертифікат або закритий ключ активного середовища (тоді спосіб оплати приховується під час оформлення замовлення), і показує Test mode is on: payments go to the Netopia sandbox and no real money is charged., доки ввімкнено тестовий режим. Під час збереження недійсний сертифікат або закритий ключ відхиляються з помилкою, і зберігається попереднє значення; решта полів зберігаються.

IPN (confirm) URL

Він відображається лише для читання у верхній частині сторінки. За увімкнених дружніх URL він має такий вигляд: https://your-shop/module/wcp_netopia_gateway/notify, можливо, з кодом мови, наприклад /en/. Він надсилається з кожним запитом на оплату як URL підтвердження, тому вводити його в адмін-панелі Netopia не потрібно. Netopia надсилає IPN на цю адресу. Модуль розшифровує її закритим ключем того середовища, в якому розпочато оплату, і перевіряє підпис вашого облікового запису та запит на оплату. Netopia повідомляє про такі дії:

Сповіщення з кодом помилки Netopia (наприклад, відхилена картка) переводить замовлення в очікуванні в статус Payment error; без замовлення клієнт може оплатити знову. Сповіщення, які неможливо розшифрувати, які містять інший підпис облікового запису або не відповідають запиту на оплату цього кошика, відхиляються і нічого не змінюють.

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

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

Title: назва способу оплати, що показується під час оформлення замовлення. Вона також є назвою способу оплати, збереженою в замовленні. За замовчуванням: Card Payment (Netopia).

Description: опис способу оплати, що показується під час оформлення замовлення. За замовчуванням: Pay securely with your credit or debit card via Netopia.

Обліковий запис Netopia

В адмін-панелі Netopia перейдіть до Seller accounts > your point of sale > Technical settings: скопіюйте підпис облікового запису та завантажте відкритий сертифікат (.cer) і закритий ключ (.key) кожного середовища. Відкрийте файли в текстовому редакторі та вставте весь їх вміст, включно з рядками BEGIN/END.

Account signature: підпис облікового запису продавця (формат XXXX-XXXX-XXXX-XXXX-XXXX), однаковий для sandbox і робочого середовища.

Test mode: використовує sandbox Netopia (sandboxsecure.mobilpay.ro) і ключі sandbox. За замовчуванням: on. Вимкніть його, щоб приймати реальні платежі з робочими ключами.

Sandbox public certificate (.cer): вміст файлу відкритого сертифіката sandbox. Він використовується для шифрування запиту на оплату.

Sandbox private key (.key): вміст файлу закритого ключа sandbox. Він використовується для розшифрування IPN.

Live public certificate (.cer): вміст файлу відкритого сертифіката робочого середовища.

Live private key (.key): вміст файлу закритого ключа робочого середовища.

Збережені закриті ключі ніколи не показуються знову. Поле залишається порожнім, а його текст підказки починається з A private key is saved. Залиште поле порожнім, щоб зберегти ключ, або вставте новий ключ, щоб його замінити. Порожнє поле сертифіката видаляє сертифікат.

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

Замовлення

Order status after payment: статус оплаченого замовлення.

Додатково

Debug log: записує запити та обробку IPN у logs/netopia_p_debug.log.php у папці модуля. Файл неможливо відкрити через веб. Дані картки, ключі та дані клієнтів не журналюються. Помилки, наприклад відхилені IPN, завжди журналюються, навіть коли опцію вимкнено. За замовчуванням: off.

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

Delete data on uninstall: під час видалення модуля видаляє налаштування шлюзу, записи платежів Netopia модуля та журнал. Замовлення зберігаються. За замовчуванням: off.

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

На етапі оплати покупець обирає спосіб оплати (за замовчуванням Card Payment (Netopia)) і підтверджує. Наступна сторінка показує Redirecting you to Netopia for secure payment… і автоматично перенаправляє покупця на сторінку оплати Netopia; як запасні варіанти є кнопки Proceed to payment і Cancel (повернення до оформлення замовлення). Запит на оплату шифрується вашим сертифікатом Netopia і містить суму кошика у валюті кошика, Cart # з номером кошика, а також контактні дані для оплати та доставки. У режимі sandbox запит надсилається до sandbox Netopia. На цьому етапі замовлення ще не існує.

Покупець платить карткою на сторінці Netopia і повертається до вашого магазину. Саме повернення ніколи не створює і не оплачує замовлення. Замовлення позначається оплаченим лише після того, як Netopia підтверджує його через IPN. Якщо замовлення існує, покупець бачить стандартну сторінку підтвердження замовлення. Для замовлення в очікуванні показується Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. Для замовлення в статусі On hold показується Your payment is awaiting confirmation. We will e-mail you as soon as the order is confirmed. Для скасованого замовлення показується The payment was cancelled at Netopia, so this order was cancelled. You can place a new order at any time. Для замовлення з помилкою оплати показується The payment was declined by Netopia.

Якщо IPN ще не надійшла, коли покупець повертається, сторінка Payment confirmation показує той самий текст «ще не підтверджено» з кнопками Check again і Back to checkout. Замовлення створюється, щойно надійде IPN.

Якщо Netopia повідомила про скасування або відмову до створення будь-якого замовлення, покупець повертається до оформлення замовлення з повідомленням The payment was cancelled at Netopia. You can try again or choose another payment method. або The payment was declined by Netopia. You can try again or choose another payment method. Кошик зберігається. Кожна нова спроба — це новий запит на оплату; попередні запити для цього кошика залишаються дійсними, тож пізня IPN з попередньої спроби все одно буде зареєстрована.

Якщо модуль налаштовано неправильно, покупець залишається в оформленні замовлення з повідомленням Netopia gateway is not configured properly. Please contact the store administrator. Інші повідомлення: Netopia cannot process payments in з валютою, This order has nothing to pay. і Payment encryption failed. Please try again or contact support. Технічна причина записується в журнал.

IPN працює, поки магазин перебуває в режимі обслуговування, і не блокується обмеженням за країнами вашого магазину.

Модуль приймає платежі карткою лише за протоколом карткових платежів Netopia v1. Він не підтримує повернення коштів і списання з PrestaShop, збережені картки або оплату в один клік, підписки, розстрочку чи інші способи оплати, а також Netopia API v2.

Замовлення та повернення

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

Замовлення ще немає: покупця було надіслано до Netopia, і він ще не оплатив, або Netopia ще не надіслала IPN. Існує лише кошик.

Payment accepted or Delivered: Netopia підтвердила платіж. Статус відповідає Order status after payment. Платіж записується з транзакцією Netopia як ID транзакції, а приватна примітка показує суму, замаскований номер картки та транзакцію Netopia; платежі sandbox позначаються як [sandbox].

Awaiting Netopia payment: платіж є попередньою авторизацією, що очікує списання в адмін-панелі Netopia, або перевіряється в Netopia. Платіж ще не зареєстровано. Замовлення переходить у статус оплаченого, коли Netopia його підтверджує.

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

Payment error: Netopia повідомила про помилку, наприклад відхилену картку, для замовлення в очікуванні.

Canceled: Netopia скасувала платіж замовлення в очікуванні.

Refunded: платіж повністю повернено в адмін-панелі Netopia.

Пізні сповіщення ніколи не знижують статус оплаченого або закритого замовлення. Якщо Netopia підтверджує інший платіж за вже оплачене замовлення, примітка попросить вас повернути дублікат в адмін-панелі Netopia.

Блок Netopia

На сторінці замовлення відображається блок Netopia Payments з транзакцією Netopia, середовищем (sandbox або робоче), запитом на оплату, останньою дією IPN, замаскованою карткою, сумами оплачено, повернуто та залишилось, а також історією повернень. Блок доступний лише для читання.

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

Повернення коштів не здійснюються з PrestaShop: протокол карткових платежів Netopia v1 не має виклику для повернення. Поверніть транзакцію в адмін-панелі Netopia. Після цього Netopia надсилає IPN про кредит, і модуль автоматично реєструє повернення в замовленні з приміткою Netopia refund processed: та сумою. Часткове повернення зберігає статус замовлення; коли нічого більше повертати, замовлення переходить у статус Refunded. Для замовлень у EUR, USD і GBP повернена сума, яку Netopia вказує в RON, перераховується назад у валюту замовлення. Повернення ніколи не реєструється двічі і не більше за залишок. Якщо Netopia повідомляє про помилку повернення, додається лише примітка.

Модуль не створює кредитових нотаток і не повертає товари на склад. Стандартні кнопки повернення PrestaShop на сторінці замовлення не повертають гроші через Netopia.

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

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

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

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

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

Netopia не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, активне середовище повністю налаштоване (Account signature плюс сертифікат і закритий ключ sandbox у тестовому режимі або робочого середовища в робочому режимі) і валюта кошика — RON, EUR, USD або GBP. Сторінка налаштувань показує попередження, якщо чогось бракує. В Payment > Preferences перевірте, що модуль дозволено для валюти кошика, країни клієнта та групи клієнта.

Платіж пройшов, але замовлення не створено: IPN не дійшла до вашого магазину або була відхилена. Перевірте, що URL IPN (підтвердження) з налаштувань доступний з інтернету (без базової автентифікації та брандмауера). Перегляньте поле Log на сторінці модуля: відхилені IPN завжди журналюються. Увімкніть Debug log, щоб бачити кожну IPN. Саме повернення клієнта ніколи не створює замовлення.

У журналі failed decrypting data: закритий ключ не відповідає сертифікату, який використала Netopia. IPN розшифровується збереженим закритим ключем кожного середовища, тож зберігайте ключ іншого середовища, поки його платежі відкриті. Netopia повторно надсилає IPN.

У журналі signature mismatch: Account signature відрізняється від точки продажу, яка надіслала IPN. Скопіюйте його знову з адмін-панелі Netopia.

У журналі unknown payment request: IPN не відповідає запиту на оплату, який ваш магазин створив для цього кошика в цьому середовищі (sandbox або робочому). Нічого не змінюється.

У журналі gateway not configured: не збережено закритий ключ або підпис облікового запису. Netopia повторно надсилає IPN, а платіж реєструється, щойно налаштування заповнено.

У журналі busy, retry later or processing failed: кошик у цей самий момент обробляв інший запит, або замовлення не вдалося створити (наприклад, модуль вимкнено). Netopia автоматично повторно надсилає IPN.

Помилка під час збереження сертифіката або закритого ключа: вставлений текст не є дійсним сертифікатом чи ключем. Вставте повний вміст файлу, включно з рядками BEGIN/END. Попереднє значення збережено.

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

Повернення, оформлене в Netopia, не з'являється в замовленні: IPN про кредит не дійшла до магазину або була відхилена. Перегляньте журнал.

Видалення

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

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