Настройка платёжной страницы QryptoPay
Эта статья — продолжение гайда по добавлению первого кошелька для приёма платежей. Кошелёк добавлен, деньгам есть куда приходить — теперь клиентам нужна страница, на которой они смогут проводить оплаты.
💡 Этот шаг может быть уже пройден
Если при создании мерчанта в быстром старте вы указали домен, платёжная страница создалась вместе с ним. Откройте мерчант, проверьте, что страница открывается по вашему домену, и переходите к следующему шагу. Дальше — для тех, у кого домена тогда не было или страницу создать не удалось.
Что нужно
- Модуль Nginx — платёжная страница работает как виртуальный хост Nginx, без него её не поднять. Если модуль ещё не установлен, откройте раздел Nginx в боковом меню, нажмите «Установить» и дождитесь окончания установки.
- Доменное имя — направленное A-записью на сервер с панелью, например
qpay.your-site.com. Клиенты будут видеть этот адрес при оплате, поэтому берите домен, которому доверяют ваши покупатели: поддомен основного сайта подходит лучше, чем незнакомое имя.
Создание страницы
Создание страницы запускается из бокового меню:
- В боковом меню раздела QryptoPay найдите свой мерчант в списке.
- Наведите на него курсор — справа от названия появится иконка глобуса с подсказкой «Создать платежную страницу». Если Nginx не установлен, иконка неактивна и подсказывает «Сначала установите Nginx» — поставить его можно в разделе Nginx в боковом меню.
- Нажмите иконку — откроется диалог «Создать платежную страницу».
В диалоге заполните:
- Доменное имя — домен, который вы направили на этот сервер;
- в дополнительных параметрах оставьте «HTTPS (порт 443)» — для платёжной страницы будет выпущен SSL‑сертификат.
Нажмите «Создать».
После создания панель сообщит результат: страница создана, страница создана без сертификата (домен не прошёл проверку — стоит проверить A-запись и повторить) или создать страницу не удалось.
⚠️ Не редактируйте этот хост в модуле Nginx
Созданная страница появится в списке виртуальных хостов Nginx, но управлять ей нужно только из мерчанта. Панель собирает этот хост по своему шаблону — с проксированием запросов /public/api/ и /public/ws/ на сокет QryptoPay. Ручные правки перезапишутся при следующем изменении страницы из мерчанта, а если задеть эти адреса, платёжная страница перестанет отвечать и оплата остановится.
Логотип на странице оплаты
По умолчанию клиенты видят на странице оплаты стандартный брендинг QryptoPay. Вкладка «Страница оплаты» у мерчанта позволяет поставить свой логотип — тот, который клиенты знают по вашему сайту.
Логотип задаётся отдельно для светлой и тёмной темы: сначала загружается «Логотип для светлой темы», после чего становится доступен «Логотип для темной темы». Если тёмный вариант не нужен, его можно в любой момент сбросить к светлому — кнопка «Сбросить к светлому логотипу».
- Форматы: PNG, JPEG, GIF, SVG.
- Суммарный размер файлов — до 4,5 МБ.
‼️ Сброс брендинга необратим
Кнопка «Сбросить весь брендинг» удаляет оба логотипа, и страница оплаты возвращается к стандартному виду QryptoPay. Отменить это действие нельзя — логотипы придётся загружать заново.
Следующий шаг
Теперь клиенты смогут попасть на страницу оплаты и провести платёж. Осталось подключить к терминалу ваш магазин, чтобы оплата была полностью автоматизирована:
- Интеграция магазина с QryptoPay — платёжные ссылки, вебхук и сквозной тестовый платёж.