Revolut Checkout for VirtueMart - Расширение Joomla

Руководство по настройке Revolut Checkout for VirtueMart в Joomla-магазине

Revolut Checkout for VirtueMart нужен не просто для добавления еще одного способа оплаты в корзину. Это платежное расширение соединяет магазин на Joomla и VirtueMart с Revolut Merchant, выводит покупателю виджет оплаты, передает заказ в платежную сторону и после успешной операции меняет статус заказа в магазине по выбранным правилам.

В этом руководстве разберем практический путь: что проверить до установки, где включить плагин в Joomla, как создать платежный метод в VirtueMart, какие поля настроить первыми, как провести тестовый заказ, где искать причину ошибки и когда лучше выбрать другой платежный сценарий. Текст рассчитан на владельца магазина, администратора Joomla или разработчика, который уже имеет доступ к сайту и хочет безопасно включить оплату картами через Revolut.

Материал не заменяет документацию разработчика и Revolut Business, но помогает связать ее с реальной логикой VirtueMart: валюты, статусы заказов, видимость платежного метода, тестовая среда, возврат покупателя после оплаты, письма магазина и диагностика. Если отдельная функция зависит от вашей версии расширения или настроек Revolut Merchant, проверяйте ее в личном кабинете и в документации, а не переносите настройки вслепую с другого сайта.

Какую задачу закрывает платежное расширение

В обычном магазине на VirtueMart заказ проходит несколько этапов: покупатель выбирает товары, заполняет данные, выбирает доставку и оплату, подтверждает покупку, а администратор получает заказ с определенным статусом. Если оплата проходит вне сайта или вручную, между заказом и фактическим поступлением денег появляется промежуток, который приходится контролировать вручную. Revolut Checkout for VirtueMart закрывает именно этот промежуток: покупатель выбирает Revolut как платежный метод, вводит карту в виджете платежной системы, а магазин получает результат операции и обновляет статус.

По информации Ignis.Dev, расширение ориентировано на владельцев VirtueMart-магазинов, у которых есть Revolut Business с подключенным Revolut Merchant. Оно поддерживает оплату банковскими картами, включая Visa и MasterCard, использует Revolut Checkout widget и не хранит платежные данные покупателя в базе Joomla. Это важное отличие от самописных форм: администратор сайта настраивает связь и статусы, но не превращает свой сайт в место хранения карточных реквизитов.

Нужно понимать границу ответственности. Расширение добавляет платежный метод в VirtueMart и помогает передать заказ в Revolut. Оно не исправляет неправильные налоги, не настраивает доставку, не заменяет проверку валют, не делает магазин автоматически совместимым с каждым шаблоном checkout и не освобождает от тестового заказа. Хорошая настройка начинается до установки: надо убедиться, что сайт уже стабильно оформляет обычные заказы, корректно считает итоговую сумму и не ломает корзину из-за кеша или конфликтующего шаблона.

Что получает покупатель

Для покупателя сценарий должен быть коротким: выбрать метод оплаты, увидеть понятный платежный виджет, подтвердить операцию и вернуться к заказу. На странице продукта Ignis.Dev описывает прозрачный переход: в конце оформления заказа на сайте открывается виджет Revolut, где покупатель вводит данные карты. Если платеж требует 3D Secure или другой шаг сильной аутентификации, подтверждение проходит в рамках платежного процесса.

Такой сценарий особенно полезен для магазинов, где важно не уводить пользователя в длинный внешний путь. Виджет не отменяет требования к чистому checkout: если сама страница корзины перегружена, мобильная верстка ломается или поля покупателя работают нестабильно, платежный метод не спасет конверсию. Поэтому в руководстве отдельно есть проверка результата на публичной части сайта.

Что получает администратор магазина

Администратор получает управляемую точку настройки в VirtueMart: платежный метод можно опубликовать, назвать понятным образом, ограничить по группам покупателей, странам, категориям, диапазону суммы или доставке, если эти параметры доступны в стандартной форме платежного метода. Сам плагин добавляет собственные поля конфигурации: среда, ключи, режим списания, создание клиента в Revolut, отладка и статусы для разных исходов оплаты.

Самая частая ошибка при внедрении платежного метода - включить его как кнопку и не проверить бизнес-логику статусов. В VirtueMart статусы управляют письмами, счетами, движением остатков и дальнейшей обработкой заказа. Поэтому успех оплаты должен переводить заказ в статус, с которым ваша команда реально работает: например, в подтвержденный или другой внутренний статус, если он настроен на складе и в письмах.

Кому Revolut Checkout for VirtueMart подойдет, а кому лучше выбрать другой путь

Расширение логично рассматривать владельцам магазинов на Joomla, которые уже используют VirtueMart и хотят принимать онлайн-оплату через Revolut Merchant без разработки собственной интеграции на Merchant API. Оно особенно уместно, если магазин продает обычные товары или услуги, обрабатывает заказы внутри VirtueMart и хочет, чтобы статус заказа менялся автоматически после подтверждения платежа.

Хороший кандидат для внедрения - магазин, где уже налажены товары, доставка, налоги, валюты, письма и оформление заказа. В такой ситуации Revolut Checkout for VirtueMart добавляет недостающий платежный слой, а не становится попыткой починить весь checkout. Если же корзина нестабильна, покупательские поля меняются от шаблона к шаблону, а статусы заказов не продуманы, сначала стоит привести в порядок основу VirtueMart.

Когда расширение особенно полезно

• Магазин уже работает на Joomla и VirtueMart, а команда не хочет переносить каталог на другую платформу ради платежей.
• Нужна оплата картами через Revolut Merchant с 3D Secure и SCA, а карточные данные не должны храниться в базе сайта.
• Администратору важно выбирать статусы для ожидания, успешной и отмененной оплаты внутри VirtueMart.
• Нужна тестовая среда перед запуском, чтобы проверить заказ без риска для реальных покупателей.
• Магазин работает с валютами, которые поддерживает расширение и сам Revolut Merchant в вашей учетной записи.

Когда стоит остановиться и проверить альтернативы

Если у вас нет Revolut Business и подключенного Merchant account, расширение не решит задачу само по себе. Если магазин продает в валюте, которой нет в списке поддерживаемых на странице продукта, платежный метод может не появиться в нужном сценарии или заказ не пройдет корректно. Если бизнесу нужна локальная платежная система с банковскими переводами, BLIK, рассрочками или региональными методами, ближе могут оказаться Tpay, Przelewy24 или другой оператор с VirtueMart-плагином.

Отдельно оцените архитектуру checkout. Revolut официально предлагает разные платежные решения: встроенный Revolut Checkout, отдельные карточные сценарии, Hosted Checkout Page, no-code plugins для популярных платформ и прямую Merchant API интеграцию. Ignis.Dev закрывает именно связку Joomla + VirtueMart + Revolut Checkout. Если вам нужна глубокая кастомизация платежного маршрута, предавторизация, отдельные серверные операции или необычная логика для бронирований, может понадобиться разработчик и прямое изучение Revolut Merchant API.

Что проверить перед установкой в Joomla и VirtueMart

Подготовка нужна не ради формальности. Платежный плагин работает на пересечении CMS, магазина, платежной системы, HTTPS, валют, статусов, шаблона checkout и серверных расширений PHP. Если один из этих элементов не готов, ошибка часто проявляется уже после выбора оплаты, когда покупатель ожидает завершить заказ.

Документация Ignis.Dev указывает базовые требования: PHP не ниже указанного в руководстве разработчика, расширения curl, mbstring и json, включенный HTTPS, VirtueMart и Joomla не ниже заявленных версий. На странице продукта также заявлена совместимость с Joomla 3.x, Joomla 4.x, Joomla 5.x, VirtueMart 3.x и VirtueMart 4.x. Эти данные стоит сверить с вашей фактической установкой, потому что старый шаблон checkout или сторонний one-page checkout может вести себя иначе, чем стандартная корзина.

Технический чек-лист до установки

Не стоит начинать с производственной оплаты. Даже если магазин небольшой, сначала включите тестовую среду, проведите один-два тестовых заказа, проверьте статусы и письма, затем переключайтесь на боевые ключи. Переключение среды без повторной проверки - одна из самых рискованных ошибок: сайт может выглядеть готовым, но фактически работать с неправильным ключом или статусом.

Что подготовить в Revolut Merchant

Для работы расширения нужен доступ к Revolut Merchant. В документации Revolut Merchant account описан как подаккаунт Revolut Business, который открывает инструменты приема платежей, управления заказами, отчетами и интеграциями. Для прямых API или некоторых плагинов используются ключи: публичный ключ для клиентской стороны и секретный ключ для серверных вызовов. В руководстве Ignis.Dev для этого расширения отдельно указаны поля Sandbox Merchant API key и Production Merchant API key.

Практический порядок такой: подготовьте тестовый доступ в sandbox, убедитесь, что Merchant account активен, не передавайте секретный ключ в переписку, заметки или сторонним подрядчикам без необходимости, а в Joomla вставляйте его только в поле конфигурации платежного метода. Если после ввода ключа плагин сообщает о несоответствии среды, не пытайтесь "угадать" правильный вариант - вернитесь в Revolut Business или sandbox и проверьте, какой ключ вы копируете.

Установка расширения и первое включение плагина

Установка проходит как у обычного Joomla-расширения, но с важным продолжением в VirtueMart. Недостаточно загрузить ZIP-файл в админ-панель: платежный плагин должен быть включен в Joomla, а затем на его основе нужно создать платежный метод в списке VirtueMart. Именно платежный метод видит покупатель на checkout.

По инструкции Ignis.Dev путь начинается в админ-панели Joomla: Extensions -> Manage -> Install, затем вкладка Upload Package File и загрузка архива расширения. После установки надо открыть Extensions -> Plugins, найти Ignisdev Revolut Checkout for Virtuemart и включить его. Только после этого плагин станет доступен в настройке VirtueMart.

Последовательность без лишнего риска

1. Сделайте резервную копию файлов и базы перед установкой, особенно если checkout уже дорабатывался.
2. Установите ZIP через штатный установщик Joomla, не распаковывая архив вручную в папки сайта.
3. Включите плагин в списке Joomla-плагинов и убедитесь, что он не оставлен в отключенном состоянии.
4. Откройте VirtueMart -> Shop -> Payment Methods и создайте новый платежный метод.
5. В поле Payment Method выберите вариант Ignisdev Revolut Checkout и сохраните запись, чтобы загрузились параметры конфигурации.
6. Настройте ключи, среду, статусы и видимость, затем опубликуйте платежный метод.

Мини-проверка после установки: если в списке платежных методов VirtueMart нет варианта Ignisdev Revolut Checkout, сначала проверьте, включен ли Joomla-плагин. Не создавайте второй платежный метод и не переустанавливайте архив, пока не проверен статус плагина.

Если установка проходит на живом магазине, лучше делать ее в период низкой нагрузки. Платежный метод можно создать неопубликованным, настроить, сохранить, затем провести проверку на тестовой среде или временно ограничить его по группе покупателей. Такой подход снижает риск, что реальный покупатель увидит недонастроенный способ оплаты.

Настройка платежного метода после установки

Главный раздел настройки находится в карточке платежного метода VirtueMart. Стандартная часть VirtueMart отвечает за имя, публикацию, описание, порядок показа, группы покупателей, страны, категории, суммы и привязку к доставке. Конфигурационная часть плагина отвечает за связь с Revolut: среду, ключи, режим списания, создание клиента, отладку и статусы заказа.

Не пытайтесь настроить все поля за один проход. Сначала добейтесь минимально работающего тестового заказа: опубликованный метод, тестовая среда, sandbox-ключ, корректная валюта, понятные статусы. Только после этого включайте дополнительные ограничения по странам, категориям, группам и доставке.

Базовые поля VirtueMart: как назвать и где показывать оплату

Название платежного метода должно быть понятным покупателю. Внутреннее название может быть техническим, но видимое название лучше сделать коротким: например, "Оплата картой через Revolut". В описании можно указать, что оплата проходит через платежный виджет Revolut и карточные данные не сохраняются магазином. Не перегружайте описание юридическими фразами: длинный текст рядом с оплатой ухудшает выбор способа.

Стандартные ограничения VirtueMart помогают не показывать метод там, где он не должен применяться. Если магазин работает в нескольких странах, а Revolut Merchant доступен не для каждого сценария бизнеса, проверьте поле стран. Если в некоторых категориях продаются товары с отдельными правилами оплаты, используйте категорийные ограничения осторожно. Если платеж зависит от доставки, учитывайте поле Shipments: оно позволяет показывать метод только при выбранной доставке.

Когда оставить ограничения пустыми

В документации VirtueMart для многих стандартных ограничений прямо описан безопасный подход: пустое значение обычно означает "для всех". На первом тесте это полезно: метод проще увидеть и проверить. После успешной проверки можно постепенно сужать видимость. Если вы сразу выбираете группу покупателей, страну, категорию и доставку, а метод не появляется на checkout, придется разбирать сразу несколько условий.

Когда ограничения действительно нужны

Ограничения нужны, если они отражают реальное бизнес-правило. Например, метод не должен показываться для валюты или страны, где вы не принимаете платежи; для товаров с ручным согласованием; для доставки, которая оплачивается иначе; для групп покупателей с постоплатой. Но каждое такое правило должно быть проверено отдельным тестовым заказом.

Среда и ключи API

Поле Environment определяет, куда плагин отправляет платежный сценарий: в тестовую или производственную среду. Для теста используйте sandbox-ключ, для реального приема оплат - production-ключ. Ошибка смешивания среды и ключа часто выглядит не как "неправильная настройка", а как неопределенная ошибка платежа, отсутствие виджета или отказ на стороне платежной системы.

Секретный ключ нельзя вставлять в публичные заметки, HTML, письма, тикеты без маскировки или скриншоты, которые видит широкий круг людей. Если ключ был случайно раскрыт, его надо перевыпустить в Revolut Business или sandbox, а в VirtueMart заменить старое значение. Секретный ключ - это не справочная настройка, а доступ к серверной интеграции.

Capture mode: автоматическое или ручное списание

В документации Ignis.Dev поле Capture mode описано как режим списания: автоматический захват платежа в Revolut Merchant или ручной захват через панель Revolut. Для обычного магазина с физическими товарами чаще проще автоматический режим: покупатель оплатил, заказ получил успешный статус, команда начинает обработку. Ручной режим имеет смысл, если вы хотите сначала проверить наличие товара, уточнить доставку или подтвердить заказ перед фактическим списанием.

Не включайте ручной режим только "на всякий случай". Он добавляет операционный шаг: сотрудник должен помнить, где и когда захватывать платеж. Если этот шаг пропустить, заказ может выглядеть почти завершенным, но деньги не будут списаны так, как ожидает бизнес-процесс. Для ручного режима подготовьте внутреннюю инструкцию: кто проверяет заказ, где смотрит авторизацию, когда выполняет захват и что делает при отмене.

Создание клиента на стороне Revolut

Поле Create Revolut Customer позволяет включить или отключить создание клиента на стороне Revolut. Включение может быть полезно, если вы хотите видеть клиентов в платежной панели и связывать операции с покупателями. Отключение может быть предпочтительным, если магазин не хочет создавать лишние клиентские записи в платежной системе для каждого теста или редкой покупки.

Решение зависит от вашего процесса поддержки и учета. Если менеджеры часто сверяют платежи по email покупателя, создание клиента может упростить поиск. Если вы храните всю клиентскую историю в VirtueMart и используете Revolut только как платежный канал, можно начать с более осторожной настройки и включить создание клиентов позже после тестов.

Статусы для ожидания, успеха и отмены

Поля Pending status, Success status и Invalid status связывают исход платежа с заказом VirtueMart. Это не косметика. Статусы влияют на письма, счета, остатки, обработку заказа и дальнейшую работу сотрудников. В VirtueMart платежные плагины, доставки, ручные обновления и сторонние расширения могут менять статусы, а преднастроенные статусы включают ожидание, подтверждение, завершение, отмену и возврат.

Для первого запуска обычно удобно использовать отдельную понятную схему: новый заказ после выбора оплаты получает статус ожидания, успешная оплата переводит его в подтвержденный или другой рабочий статус, отмененная или невалидная операция переводит в отмененный или отклоненный статус. Если у вас уже есть собственные статусы, проверьте, какие письма, счета и движения склада они запускают.

Отладка и безопасный откат

Debug нужен для диагностики, а не для постоянной работы. Включайте его на тесте или при поиске конкретной ошибки, затем выключайте. Если платежный метод уже виден покупателям, сначала убедитесь, что отладка не раскрывает лишние технические сообщения на публичной части сайта.

Откат платежной настройки должен быть простым: снимите публикацию с платежного метода, очистите кеш checkout, верните предыдущий статус или ключ, повторите тестовый заказ. Не удаляйте метод сразу после ошибки: в нем сохраняются параметры, которые помогут понять, что именно было настроено неправильно. Удаление имеет смысл только после фиксации конфигурации и если вы уверены, что метод больше не нужен.

Как работает платежный виджет и обновление заказа

Понимание механики помогает быстрее находить ошибки. Когда покупатель выбирает платежный метод Revolut в VirtueMart и подтверждает заказ, магазин формирует платежный сценарий на основе суммы, валюты, заказа и настроек метода. Далее покупателю показывается Revolut Checkout widget или платежное окно, где он вводит данные карты и проходит подтверждение. После результата платежа магазин должен получить сигнал, изменить статус заказа и показать покупателю понятный итог.

В официальной документации Revolut Checkout описан как встроенный виджет с единым управляемым интерфейсом для платежных методов Revolut. Документация по онлайн-карточным платежам также описывает card pop-up как интерактивное окно, которое активируется в процессе checkout и проводит покупателя через платежные шаги. Для владельца VirtueMart-магазина главное не в терминах SDK, а в том, что платежный интерфейс обслуживает Revolut, а ваш сайт должен корректно создать заказ и принять результат.

Почему карточные данные не должны оставаться в магазине

На странице Ignis.Dev указано, что данные клиента не хранятся на вашем сайте, а находятся в Revolut. Это снижает нагрузку на владельца магазина: Joomla не становится местом хранения карточных реквизитов. Но это не означает, что можно игнорировать безопасность сайта. Если сайт заражен, checkout ломается, HTTPS настроен неверно или админ-доступы скомпрометированы, платежный метод все равно будет работать в плохой среде.

Практический минимум безопасности: обновленная Joomla, актуальный VirtueMart, аккуратные права администраторов, защищенный доступ к панели, резервные копии, HTTPS без ошибок и отсутствие лишних расширений на checkout. Платежный плагин не должен становиться единственной защитной мерой.

Как связаны заказ, платеж и статус

В Revolut Merchant API платежные процессы строятся вокруг заказа: заказ представляет намерение покупателя приобрести товары или услуги, а после оплаты к нему привязываются платежные попытки. В VirtueMart тоже есть заказ со статусом, суммой, покупателем, доставкой и выбранным методом оплаты. Платежное расширение должно синхронизировать эти два мира настолько, насколько это предусмотрено его конфигурацией.

Если покупатель закрыл окно, не прошел 3D Secure, вернулся назад или платежная система временно не ответила, заказ может остаться в ожидании или перейти в неуспешный статус. Это нормальная часть платежной логики, а не всегда ошибка. Ошибка начинается тогда, когда менеджер не понимает, что означает статус, или когда сайт показывает покупателю успешное сообщение без подтвержденного платежа.

Что учитывать по webhooks и уведомлениям

Документация Revolut описывает webhooks как способ получать событие сразу после изменения в другой системе, например когда заказ переходит из pending в completed. Также Revolut предупреждает, что порядок доставки событий не всегда гарантирован, поэтому реализация не должна слепо зависеть от очередности уведомлений. В готовом плагине часть этой логики скрыта от администратора, но практический вывод остается тем же: проверяйте итоговый статус заказа, а не только факт возврата покупателя на страницу.

Если в вашей версии расширения нет отдельной настройки webhooks в интерфейсе, не придумывайте ее. Работайте с теми полями, которые реально доступны: ключи, среда, статусы, отладка, видимость метода. При нестабильном обновлении статусов сверяйте заказ в VirtueMart, платеж в Revolut Merchant и журнал сайта.

Практический пример: тестовый заказ в магазине на VirtueMart

Ниже - сценарий, который стоит пройти перед тем, как показывать платежный метод всем покупателям. Он специально построен вокруг типового магазина: один тестовый товар, стандартный checkout, тестовая среда Revolut, ожидаемый статус заказа и проверка публичной части сайта.

Цель сценария

Нужно убедиться, что покупатель видит метод "Оплата картой через Revolut", может открыть платежный виджет, завершить тестовую операцию, а заказ в VirtueMart меняет статус согласно настройкам. Дополнительно проверяем, что письма, счет, остатки и комментарии заказа не противоречат реальному результату оплаты.

Подготовка

• Создайте или выберите недорогой тестовый товар, который не влияет на реальный складской процесс.
• Убедитесь, что валюта товара входит в список поддерживаемых расширением и настроена в VirtueMart с корректным ISO-кодом.
• Включите тестовую среду и sandbox-ключ в платежном методе.
• Выберите статусы для ожидания, успешной и неуспешной оплаты.
• Временно ограничьте метод тестовой группой покупателей, если не хотите показывать его всем.

Шаги теста

1. Откройте публичную часть магазина в обычном браузере или в приватном окне.
2. Добавьте тестовый товар в корзину и пройдите все обязательные поля покупателя.
3. Выберите доставку, если она нужна для появления платежного метода.
4. Выберите платежный метод Revolut и подтвердите заказ.
5. Проверьте, открылся ли виджет или платежное окно, нет ли смешанного содержимого и ошибок JavaScript.
6. Завершите тестовую оплату по правилам sandbox-среды.
7. Вернитесь на страницу результата заказа и проверьте текст для покупателя.
8. Откройте заказ в админ-панели VirtueMart и сравните статус, сумму, валюту, платежный метод и историю.

Ожидаемый результат

После успешного теста заказ должен иметь выбранный успешный статус, сумма должна совпадать с итогом корзины, платежный метод должен быть указан как Revolut, а менеджер должен понимать, можно ли обрабатывать заказ дальше. Если включены письма для выбранного статуса, они должны приходить с корректным смыслом: покупателю нельзя отправлять сообщение "заказ оплачен", если фактически он остался в ожидании.

Нюанс, который часто мешает тесту

Платежный метод может не появиться не из-за Revolut, а из-за условий VirtueMart: страна покупателя не входит в разрешенный список, выбранная доставка не совпадает с настройкой, сумма заказа ниже или выше диапазона, группа пользователя не подходит, категория товара заблокирована. Поэтому при первом тесте лучше оставить ограничения пустыми, а затем добавлять их по одному.

Проверка результата после запуска

Запуск платежного метода считается завершенным не в момент публикации, а после нескольких проверенных заказов. Нужны минимум три сценария: успешная оплата, отмененная или не завершенная оплата и заказ, где метод не должен появляться из-за ограничений. Только так можно понять, что настройки работают не случайно.

Что смотреть в заказе VirtueMart

Откройте список заказов и карточку конкретного заказа. Документация VirtueMart описывает список заказов как место, где видны номер заказа, имя покупателя, платежный метод, доставка, дата, оплаченная сумма, статус и итог. Для Revolut-сценария особенно важны четыре поля: статус, оплаченная сумма, метод оплаты и комментарии или история изменений.

Если заказ успешен, статус должен соответствовать вашей настройке Success status. Если покупатель отменил платеж, статус не должен выглядеть как оплаченный. Если заказ остался в ожидании, не отправляйте товар без сверки в Revolut Merchant. В спорной ситуации сравнивайте сумму и валюту в VirtueMart с операцией в панели Revolut.

Что смотреть в Revolut Merchant

В Revolut Merchant проверяйте, создан ли платежный объект, какая у него сумма, валюта и итоговый статус. Если вы используете ручной режим списания, отдельно убедитесь, что авторизация не осталась без захвата. Если платежа нет, а заказ есть, проблема может быть до открытия виджета или при создании платежного запроса. Если платеж есть, но статус VirtueMart не обновился, смотрите возврат, уведомления, логи и настройки статусов.

Проверка публичной части

Платежный сценарий должен быть понятен на настольном и мобильном экране. Проверьте, не перекрывает ли виджет элементы шаблона, не теряется ли кнопка подтверждения, не уходит ли покупатель на пустую страницу после возврата. Если в магазине установлен одностраничный checkout, проверьте его отдельно: такие расширения часто меняют порядок обновления доставки, оплаты и пользовательских полей.

Правило запуска: пока вы не видели успешный тестовый заказ в VirtueMart и соответствующий платеж в Revolut Merchant, не считайте метод готовым для реальных покупателей.

Валюты, статусы и локализация: три участка, где чаще всего ошибаются

Revolut Checkout for VirtueMart кажется простым, пока магазин работает в одной валюте, с одним языком и одним стандартным процессом обработки заказов. Но реальные магазины часто сложнее: несколько валют, мультиязычный сайт, разные страны доставки, отдельные письма и пользовательские статусы. Эти участки лучше настроить до массового запуска.

Валюты и формат сумм

На странице продукта Ignis.Dev перечислены поддерживаемые валюты расширения: EUR, GBP, USD, CAD, CHF, JPY, AUD, HKD, SEK, DKK, NOK, NZD, PLN, ZAR. В VirtueMart валюта имеет имя, публикацию, курс, ISO-коды, символ, формат и число десятичных знаков. Для платежного метода важен не только красивый символ на витрине, а корректный трехбуквенный код и итоговая сумма заказа.

Если магазин показывает цены в одной валюте, а платеж уходит в другой, проверьте настройки валюты, базовую валюту магазина, правила пересчета и то, поддерживает ли выбранную валюту ваша учетная запись Revolut Merchant. Не добавляйте валюту только ради отображения на витрине, если платежная сторона ее не принимает в вашем сценарии.

Статусы и письма

VirtueMart использует статусы не только для фильтра в админке. Они могут влиять на письма покупателю, письма продавцу, создание счета, движение остатков, удаление купона, разрешение отзывов и другие действия. Поэтому статус успешной оплаты должен соответствовать реальному следующему шагу. Если успешный статус автоматически создает счет и письмо, убедитесь, что это письмо не уходит при неуспешной оплате.

Не бойтесь использовать собственный статус, если процесс магазина этого требует. Но перед этим проверьте, какие расширения реагируют на него: склад, бухгалтерия, доставка, CRM, выгрузка в учетную систему. Платежный метод может честно поставить выбранный статус, но сторонняя автоматизация сделает с ним то, что вы не ожидали.

Локализация сообщений

В инструкции Ignis.Dev есть важная подсказка: сообщения, включая thank you message после покупки, можно переопределять, а доступные константы стоит смотреть в файле en-GB.plg_vmpayment_ignisdev_revolut_checkout.ini в папке языков админ-панели. Для Joomla безопаснее использовать штатные языковые переопределения, а не править файл расширения напрямую.

Практический подход такой: найдите точную языковую константу, создайте переопределение через менеджер языков Joomla, проверьте текст на странице результата и сохраните заметку для будущих обновлений. Не меняйте исходный файл плагина: при обновлении расширения такая правка может исчезнуть, а найти ее потом будет сложно.

Совместимость с шаблоном, кешем и одностраничным checkout

Платежный виджет работает внутри уже существующего checkout. Поэтому качество интеграции зависит от того, как шаблон и дополнительные расширения обрабатывают форму заказа. Если стандартная корзина VirtueMart работает, а одностраничный checkout ломает обновление метода оплаты, проблема может быть не в Revolut, а в перехвате событий, кешировании или шаблонном override.

Кеш и оптимизация

Страницы корзины, оформления заказа, возврата после оплаты и пользовательских данных нельзя кешировать как обычные статические страницы. Если оптимизатор объединяет скрипты, откладывает JavaScript или кеширует HTML checkout, виджет может не открываться, метод может не обновляться после выбора доставки, а статус может казаться неправильным. Начинайте диагностику с временного отключения агрессивных оптимизаций именно на checkout.

Безопасный порядок проверки: очистить кеш Joomla, очистить кеш стороннего оптимизатора, исключить страницы checkout из кеширования, повторить тест в приватном окне, затем возвращать оптимизации по одной. Не отключайте весь кеш навсегда, если проблема касается только корзины. Цель - изолировать динамический платежный маршрут.

Шаблонные override

Многие VirtueMart-магазины используют шаблонные переопределения для корзины и оформления заказа. Это нормально, но старый override может не учитывать новые поля, токены, события или скрипты. Если после обновления VirtueMart или установки платежного плагина виджет не открывается, сравните поведение на стандартном шаблоне или временно отключите override checkout на тестовой копии.

Не правьте ядро VirtueMart и файлы плагина. Если нужна визуальная адаптация, используйте шаблонные override Joomla/VirtueMart или CSS вашего шаблона. Если нужно поменять текст, используйте языковые переопределения. Если требуется изменить платежную логику, лучше обратиться к документации разработчика или к специалисту по VirtueMart, потому что самовольная правка платежного кода может создать ошибку в заказах.

Одностраничные корзины

Одностраничный checkout может менять порядок выбора доставки, пересчета суммы и показа платежей. Если Revolut не появляется только в таком checkout, проверьте: обновляется ли список платежных методов после смены страны, доставки и группы покупателя; не блокирует ли шаблон всплывающее окно; не загружается ли платежный скрипт до того, как VirtueMart создал заказ. В спорной ситуации временно переключитесь на стандартный checkout и сравните результат.

Видео с примером использования плагина

На странице продукта Ignis.Dev указан точный YouTube-ролик с примером использования Revolut Checkout plugin for VirtueMart. Его имеет смысл смотреть после прочтения разделов про установку и настройку: тогда видео не заменяет инструкцию, а помогает визуально сопоставить путь покупателя, выбор платежного метода и итоговый результат заказа.

Используйте ролик как проверочный ориентир для intent-кластера "как пользоваться Revolut Checkout for VirtueMart" и "пример оплаты через Revolut в VirtueMart". Если интерфейс в вашем магазине отличается из-за версии Joomla, шаблона или checkout-расширения, опирайтесь на логику сценария, а не копируйте каждый экран дословно.

Если оплата не проходит или метод не появляется

Диагностику лучше вести от простого к сложному. Сначала проверьте, виден ли платежный метод в VirtueMart и опубликован ли он. Затем проверьте условия показа. После этого переходите к ключам, среде, HTTPS, валютам, кешу и статусам. Такой порядок экономит время: многие проблемы выглядят как ошибка платежной системы, хотя причина находится в обычном условии VirtueMart.

Метод оплаты не виден на checkout

Симптом: в админ-панели платежный метод создан, но покупатель не видит его при оформлении заказа.

Возможные причины: Joomla-плагин отключен, платежный метод не опубликован, выбранная страна или группа покупателя не подходит, метод привязан к другой доставке, сумма заказа вне диапазона, категория товара заблокирована или кеш показывает старую форму checkout.

Что проверить

• Статус плагина в Extensions -> Plugins.
• Поле Published в платежном методе VirtueMart.
• Ограничения по Shopper Group, Countries, Categories, Shipments и сумме заказа.
• Очистку кеша Joomla и стороннего оптимизатора.

Как исправить: временно оставьте ограничения пустыми, проверьте метод на тестовом товаре, затем возвращайте ограничения по одному. Если метод появился после очистки кеша, добавьте страницы checkout в исключения.

Виджет не открывается или появляется ошибка после подтверждения заказа

Симптом: покупатель выбирает Revolut, подтверждает заказ, но платежное окно не открывается, страница зависает или показывает техническую ошибку.

Возможные причины: неправильная среда, неподходящий ключ API, проблема HTTPS, ошибка JavaScript в шаблоне, заблокированный платежный скрипт, отключенный curl или конфликт с одностраничным checkout.

Как исправить: сравните Environment и ключ, включите отладку только на время теста, проверьте консоль браузера, повторите тест на стандартном checkout или без агрессивной оптимизации JavaScript. Если ошибка указывает на серверную связь, проверьте PHP-расширения и доступ сайта к внешним запросам.

Заказ оплачен, но статус в VirtueMart не меняется

Симптом: в Revolut Merchant платеж выглядит успешным, а заказ в VirtueMart остается в ожидании или в старом статусе.

Возможные причины: неверно выбран Success status, сайт не получил или не обработал уведомление, покупатель не вернулся на страницу результата, кеш или безопасность блокируют callback, стороннее расширение изменило статус после плагина.

Что проверить: историю заказа, выбранные статусы в методе оплаты, журналы Joomla, логи сервера, настройки безопасности и наличие сторонних расширений, которые реагируют на смену статуса. Сверьте время операции в Revolut и время последнего изменения заказа.

Когда откатывать: если реальные заказы остаются в ожидании, временно снимите публикацию с метода или ограничьте его тестовой группой, пока не найдете причину. Не отправляйте заказ только по словам покупателя без сверки платежа.

Платеж отклоняется на 3D Secure или SCA

Симптом: покупатель доходит до подтверждения, но операция не завершается.

Возможные причины: банк покупателя отклонил проверку, карта не подходит, покупатель закрыл подтверждение, тестовая карта не соответствует sandbox-сценарию, сумма или валюта не проходит на стороне платежной системы.

Как действовать: проверьте платеж в Revolut Merchant, не меняйте успешный статус вручную без подтверждения, предложите покупателю повторить оплату или выбрать другой метод, если он доступен. Если проблема воспроизводится на разных картах, возвращайтесь к настройкам ключей, валюты и среды.

После оплаты покупатель видит непонятное сообщение

Симптом: оплата проходит, но текст благодарности, ошибка или язык сообщения не подходит магазину.

Возможные причины: стандартные языковые строки расширения, неподходящий язык сайта, отсутствие переопределений Joomla, шаблон checkout выводит сообщение не там, где ожидает администратор.

Как исправить: найдите языковые константы в файле en-GB.plg_vmpayment_ignisdev_revolut_checkout.ini, создайте штатное языковое переопределение Joomla и проверьте результат на тестовом заказе. Не редактируйте файл расширения напрямую.

Когда Revolut Checkout for VirtueMart будет удачным выбором

Revolut Checkout for VirtueMart стоит использовать, если ваш магазин уже работает на Joomla и VirtueMart, бизнес готов принимать платежи через Revolut Merchant, а вам нужен управляемый платежный метод с виджетом, тестовой средой, настройкой статусов и понятным путем покупателя. Сильная сторона расширения - не в большом количестве настроек, а в точной связке: заказ VirtueMart, платежный виджет Revolut, результат операции и обновление статуса.

Перед тем как загрузить Revolut Checkout for VirtueMart, проверьте три вещи: ваш сайт стабильно оформляет обычные заказы, валюта и регион соответствуют вашему Revolut Merchant, а команда понимает, какие статусы запускают письма, счета и обработку заказа. Если эти условия выполнены, расширение можно тестировать последовательно: установка, тестовая среда, один товар, успешный и неуспешный заказ, проверка в VirtueMart и Revolut.

Если же магазин еще нестабилен, checkout сильно изменен сторонним расширением или бизнесу нужны локальные способы оплаты, которых нет в Revolut-сценарии, не торопитесь. Сначала приведите в порядок корзину и статусы, затем сравните близкие платежные решения. Хороший платежный метод должен не просто появиться в списке, а стать надежной частью процесса заказа.