Magento буває вимогливим. Платіжні налаштування — теж. Якщо ви шукаєте, як підключити Payora до Magento, спершу визначте, чи працюєте ви в Magento 2 або Adobe Commerce, бо адмінські екрани досить схожі, щоб заплутати, і водночас досить різні, щоб втратити годину.
Цей посібник підходить для магазинів, де ви маєте доступ до панелі Admin, можете змінювати способи оплати та редагувати налаштування модуля без допомоги розробника на кожному кроці. Якщо ваш магазин працює з обмеженими правами, спершу отримайте тимчасовий доступ. Однієї відсутньої ролі вистачить, щоб заблокувати весь процес.
1. Переконайтеся, що це правильне Magento-оточення для Payora
Користуйтеся цим шляхом, якщо ваш магазин на Magento 2 або Adobe Commerce і ви можете встановити або увімкнути платіжний модуль. Старіші збірки Magento часто потребують іншого підходу до супроводу, і те саме стосується випадків із сильно кастомізованим оформленням кошика. Перевизначення теми може приховати спосіб оплати, навіть якщо модуль активний.
Перед тим як торкатися платіжних налаштувань, перевірте, хто відповідає за три речі: кодову базу, конфігурацію платежів і webhook-ендпоінт. Якщо хоча б одна з них у третьої сторони, вам потрібне її погодження. Це звучить бюрократично — аж доки живе оформлення замовлення не зламається о 18:00.
Для команд, що порівнюють варіанти, Payora підходить магазинам, які хочуть криптоплатежі в Magento без потреби переробляти весь процес оформлення замовлення. Якщо ви ще вирішуєте, як саме Payora працюватиме на сайті, також перегляньте гайд що таке криптоплатіжний шлюз; він допоможе зрозуміти, чи потрібна вам пряма оплата в кошику, рахунок до оплати чи обидва варіанти.
2. Зберіть платіжні дані Magento, які знадобляться Payora
Перед встановленням зберіть точні значення, які попросить модуль. Мінімально очікуйте API-ключі, ідентифікатор продавця, callback- або webhook-URL, а також налаштування store view чи валюти, які ви плануєте використовувати. Якщо бракує хоча б одного поля, зазвичай це закінчується повторними тестовими збереженнями та плутаниною в логах.
Запишіть значення один раз. Потім перевірте ще раз. Помилка в рядковому регістрі в URL ендпоінта може зупинити підтвердження платежу ще до того, як воно потрапить у Magento, а виглядатиме це як «платіж у процесі» — доки хтось не відкриє логи.
Якщо у команди є власний стандарт назв, використовуйте його. Якщо мерчант-акаунт спільний для кількох вітрин, чітко позначте кожен store view. Інакше перший запит на повернення коштів перетвориться на гру в здогадки.
Багато магазинів також задають тут валютні правила. Якщо каталог працює в USD, але на одному store view на checkout має показуватися EUR, переконайтеся, що Payora і Magento однаково бачать список підтримуваних валют. Один розбіг — і спосіб оплати може зникнути на етапі оформлення без очевидного попередження.
3. Встановіть або увімкніть платіжний модуль Payora в Magento
Налаштування платіжного шлюзу Magento зазвичай починається з файлів модуля, а не зі сторінки параметрів. Розмістіть розширення там, де цього очікує ваш процес деплою, а потім виконайте стандартний крок оновлення або увімкнення, який використовує ваша команда. Якщо сайт керується через Composer, тримайте версію в синхроні з рештою коду магазину.
Після деплою відкрийте Admin і перевірте, чи з’явився модуль у способах оплати. Вам потрібне підтвердження в інтерфейсі, а не лише зелений лог деплою. Якщо модуль є в коді, але відсутній в Admin, Magento ще не повністю його зареєструвала.
Деяким магазинам також потрібно очистити кеш або повторно індексувати конфігурацію, перш ніж спосіб оплати з’явиться. Не здогадуйтеся. Виконайте той самий післядеплойний чекліст, який ваша команда використовує для будь-якого нового платіжного методу, а потім оновіть сторінку платіжних налаштувань і знайдіть Payora за назвою.
Якщо вам потрібен орієнтир щодо полів для розробника та поведінки callback, сторінка документації для розробників, API криптоплатіжного шлюзу — саме те місце, де можна перевірити точні назви API. Тут важливі навіть дрібні відмінності в полях.
4. Завершіть налаштування платіжного шлюзу Magento в Admin
Відкрийте розділ конфігурації платежів і спершу заповніть основні параметри. Оберіть правильний режим середовища, введіть назву, яку бачитимуть клієнти, і переконайтеся, що спосіб оплати увімкнено для відповідного store view. Саме це команди найчастіше роблять поспіхом — і проблеми з’являються пізніше.
Обережно налаштуйте дозволені валюти. Якщо магазин продає у 2 валютах, обидві мають підтримуватися шлюзом і бути дозволені в налаштуванні платіжного шлюзу Magento. Якщо якась валюта не підтримується, вимкніть її тут, а не змушуйте клієнтів самостійно виявляти проблему на checkout.
Окремої уваги потребує мапінг статусів замовлення. Оплачене замовлення не повинно мати той самий статус, що й неоплачене. Налаштуйте початковий стан, стан підтвердженої оплати та будь-який стан ручної перевірки, щоб служба підтримки могла швидко читати таймлайн.
Правила відображення прості, але корисні. Обмежте Payora сторінками checkout, де це доречно, і не показуйте його в запитах на комерційну пропозицію або внутрішніх адмін-замовленнях, якщо для цього немає окремого процесу. Один із моїх клієнтів залишив спосіб оплати видимим усюди, і підтримка тиждень відповідала, чому замовлення співробітників виглядають як замовлення клієнтів.
5. Налаштуйте криптоплатежі Magento для вашого checkout-потоку
Тепер важливим стає сам досвід оплати. У криптоплатежах Magento клієнт зазвичай обирає Payora, бачить інструкції, а потім надсилає кошти через платіжний потік, який надає шлюз. Зробіть цю послідовність короткою. Довгі платіжні сторінки люди покидають дуже швидко.
Визначте, де саме з’являються платіжні інструкції після оформлення замовлення. Деякі магазини розміщують їх на сторінці успішного оформлення; інші перенаправляють клієнта на окрему платіжну сторінку. У будь-якому разі клієнт має чітко бачити суму, платіжний актив і часовий ліміт. Якщо ці дані заховані за другим входом, чекайте звернень у підтримку.
Після створення інвойсу Magento має показувати замовлення як таке, що очікує оплати, доки Payora не підтвердить платіж. Така пауза — це нормально. Не переводьте замовлення в processing занадто рано, інакше фінансам доведеться все розрулювати пізніше.
Якщо ваш магазин працює з підписками або повторними покупцями, залишайте мову оплати простою. «Оплатити через Payora» краще, ніж технічний опис, який зрозуміє лише операційна команда. Клієнт хоче завершити один платіж, а не вивчати протокол.
6. Налаштуйте обробку замовлень, інвойсів і статусів
Обробка замовлень — це місце, де платіжні модулі справді показують свою цінність. Вирішіть, що відбувається, коли Payora підтверджує оплату, коли платіж втрачає чинність і коли клієнт скасовує процес посередині. Якщо шлюз надсилає успішний callback, а Magento все ще тримає замовлення в pending, значить, мапінг налаштовано неправильно.
Правила створення інвойсу потрібно задати до запуску. Деякі магазини створюють інвойс лише після підтвердженої оплати; інші роблять це раніше з бухгалтерських причин. Обидва варіанти можуть працювати, але правило має бути зафіксоване заздалегідь, щоб підтримка не вигадувала його на живих замовленнях.
Невдалі платежі потребують окремого сценарію. Якщо Payora повідомляє про помилку, Magento не повинна вічно тримати застарілий статус «очікує оплату». Закрийте цикл через failed або canceled, а потім переконайтеся, що клієнт може повторити спробу без створення дубліката замовлення.
Для обробки callback і перевірок безпеки варто переглянути статтю про кращі практики безпеки криптоплатіжного шлюзу. Підписаний webhook і перевірене джерело — нудні деталі. Водночас саме вони зупиняють більшість спроб платіжного шахрайства.
І ще одне: повернення коштів і скасування мають йти окремим потоком від підтвердження платежу. Якщо операційна команда робить refunds вручну, задокументуйте кількість кроків і відповідальну особу. Повернення без аудиторського сліду легко перетворюється на довгий робочий день.
7. Протестуйте checkout із Payora від кошика до сплаченого замовлення
Запустіть щонайменше один повний тест від кошика до сплаченого замовлення. Використайте sandbox, якщо Payora його надає, або контрольований live-тест, якщо ваша команда це схвалює. Вам потрібно побачити сторінку checkout, платіжні інструкції, callback і оновлений статус замовлення в Admin.
Почніть із товару з низьким ризиком. Додайте його в кошик, пройдіть checkout і стежте, щоб спосіб оплати з’явився саме там, де ви очікуєте. Якщо Payora не відображається, проблема зазвичай у прапорі конфігурації, невідповідності валют або налаштуванні store view.
Потім перевірте адміністративну сторону. Успішний тест має спричинити зміну статусу, а часто й створення інвойсу або платіжного запису. Якщо на вітрині показано «paid», а Magento досі каже «pending», зупиніться й перевірте лог callback, перш ніж повторювати спробу.
Також протестуйте один сценарій із завершенням строку дії. Дайте часовому вікну платежу сплинути й переконайтеся, що замовлення не залишається напівзавершеним назавжди. Мертві замовлення швидко накопичуються, а підтримка ненавидить чистити їх по одному.
Якщо ваша команда підтримує більше однієї платформи, логіка checkout може здаватися знайомою. Процес у прийомі криптоплатежів у WordPress використовує схожі перевірки підтвердження, хоча адмін-обробка Magento — це окрема історія.
8. Усуньте типові проблеми з підключенням у Magento
Звичні блокери не надто ефектні. Неправильний callback-URL. Неактивований модуль. Невідповідність валют. Вимкнений спосіб оплати в неправильному store view. Кожна з цих проблем дає свій симптом, і кожну можна виправити, щойно ви перестанете вважати, що шлюз зламаний.
Якщо callback-и взагалі не приходять, протестуйте ендпоінт напряму й переконайтеся, що сервер приймає вхідні запити з того середовища Payora, яке ви налаштували. Правило файрвола може блокувати все, поки в адмінці Magento все виглядає цілком здоровим. Це найгірший вид «здоров’я».
Якщо спосіб оплати є в Admin, але не відображається на checkout, перевірте правила видимості та умови quote. Деякі магазини ховають способи оплати за сумою кошика, країною доставки або групою клієнтів. Одного прихованого фільтра достатньо, щоб Payora зникла.
Якщо синхронізація статусів платежу запізнюється, ще раз перевірте мапінг стану замовлення та порівняйте його з відповіддю шлюзу. Код може бути правильним, але магазин може чекати значення статусу, яке Payora ніколи не надсилає. Така невідповідність дуже поширена в проєктах налаштування платіжного шлюзу Magento, де першу конфігурацію просто скопіювали з іншого магазину і не почистили.
Для назв API-полів, поведінки ендпоінтів і будь-якого специфічного для магазину формату запиту тримайте сторінку документації для розробників, API криптоплатіжного шлюзу відкритою під час діагностики. Одного відсутнього параметра вистачить, щоб заблокувати весь процес.
Ось практичний чекліст, який можна пройти за 10 хвилин:
- Переконайтеся, що модуль Payora увімкнено в правильному store view Magento.
- Перевірте, що webhook або callback-URL відповідає live-середовищу.
- Переконайтеся, що дозволені валюти включають валюту checkout.
- Перевірте, що мапінг статусів замовлення відповідає фактичним значенням відповіді Payora.
- Зробіть одне тестове замовлення і стежте за оновленнями і у вітрині, і в Admin.
Якщо магазином користуються кілька адміністраторів, обмежте, хто може змінювати платіжні налаштування. Двоє людей, які редагують один і той самий шлюз в один день, — це як «тимчасові» виправлення стають постійними помилками. Залиште одного відповідального або принаймні одного того, хто погоджує зміни.
Magento суворий, але це може бути плюсом. Коли модуль встановлено, налаштування завершено, а callback-и перевірено, Payora поводиться передбачувано в процесі оформлення замовлення — а саме цього більшість продавців і хочуть від способу оплати.
Коментарі