Как принимать Monero (XMR)
Monero подключается к QryptoPay не так, как остальные сети, поэтому мы собрали весь путь в одной статье: что должно быть готово заранее, чем приём XMR отличается от других валют, как подключить кошелёк и ноду и как убедиться, что деньги доходят.
Что нужно до начала
Приём Monero — это последний шаг, а не первый: он настраивается поверх уже работающего модуля. К этому моменту у вас должны быть готовы:
- Модуль QryptoPay установлен и мерчант создан — см. QryptoPay. Быстрый старт.
- Платёжная страница создана и открывается по вашему домену — см. Настройка платёжной страницы QryptoPay.
- Интеграция магазина настроена и доведена до тестового платежа — токены терминала, платёжные ссылки и вебхук; см. Интеграция магазина с QryptoPay.
- В лицензии оформлена позиция Monero — см. Как оформить лицензию.
⚠️ Без позиции лицензии Monero не появится в списке валют
Кошелёк при этом можно создать, и он будет работать, но покупателю Monero на платёжной странице не предложат. Если XMR не появился в списке валют мерчанта — начните проверку с лицензии.
Если что-то из первых трёх пунктов ещё не сделано, вернитесь к соответствующей статье: без платёжной страницы и вебхука приём не заработает ни в одной валюте, и Monero тут не исключение.
Чем приём Monero отличается от других валют
| Сеть | Что вы вводите в панели | Кто может тратить | Выплаты и сбор средств |
|---|---|---|---|
| Bitcoin, Litecoin | расширенный публичный ключ | только вы, в своём приложении | не нужны: деньги сразу у вас |
| Ethereum, Tron | приватный ключ | панель, по вашему порогу выплаты | есть |
| Monero | основной адрес и приватный ключ просмотра | только вы, в своём приложении | не нужны: деньги сразу у вас |
Панель получает от вас не ключ, которым можно тратить, а ключ, которым можно только смотреть: она видит поступления, считает по ним баланс и закрывает счета, но распорядиться деньгами не может. Деньги покупателей при этом сразу оказываются на вашем кошельке — собирать их с промежуточных адресов не нужно.
Поэтому для Monero в панели нет ни кошелька для выплат, ни порога выплаты, ни резерва на комиссии сети: расходовать деньги панели нечем.
Шаг 1. Подключите кошелёк
Что взять из своего кошелька
Кошелёк Monero заводится в любом приложении, которому вы доверяете, — например в официальном Monero GUI Wallet или в мобильном Cake Wallet. Панели нужны из него такие значения:
- основной адрес — публичный адрес кошелька, 95 символов, начинается с
4; - приватный ключ просмотра (private view key) — 64 символа в hex-формате.
В большинстве приложений значения лежат рядом, в разделе с ключами кошелька: адрес — на главном экране или на вкладке получения средств, ключ просмотра — там же, где приложение показывает секретную фразу.
⚠️ Не перепутайте ключи
Панели нужен именно ключ просмотра, а не приватный ключ траты (private spend key) и не секретная фраза. Ключ просмотра позволяет видеть входящие переводы и ничего больше — отдать его панели безопасно. Ключ траты и секретная фраза дают полный доступ к деньгам, их не передают никому.
Что заполнить в панели
Откройте QryptoPay → Обзор → Последние кошельки → «Добавить кошелёк» и заполните поля:
- Имя — любое удобное название, от 2 до 64 символов;
- Блокчейн — Monero;
- Основной адрес — публичный адрес вашего кошелька;
- Приватный ключ просмотра — ключ, которым панель будет видеть поступления;
- Почта для уведомлений — адрес электронной почты для писем о состоянии кошелька.
Больше ничего вводить не нужно: ни формата адреса, ни кошелька для выплат, ни даты, с которой начинать. Момент, с которого панель начинает следить за кошельком, она определяет сама.
ℹ️ Интегрированный адрес не подойдёт
Панель принимает только основной адрес кошелька. Интегрированный адрес (он длиннее, 106 символов) будет отклонён при сохранении.
⚠️ Учёт начинается с момента подключения
Кошелёк увидит только те платежи, которые пришли после подключения. Всё, что поступило на этот кошелёк раньше, панель не увидит уже никогда: пересчитать историю для Monero нечем. Если вы собираетесь принимать оплату на кошелёк, которым уже пользовались, деньги на нём останутся вашими — просто панель их не покажет.
После сохранения панель начнёт выдавать покупателям адреса для оплаты из этого кошелька — отдельно ничего настраивать не нужно.
Кошелёк Monero на сервере один
Monero принимается на один кошелёк — адреса для покупателей панель выдаёт из него сама, поэтому второй не нужен. Это относится ко всему серверу целиком, а не к отдельному мерчанту: пока на сервере есть включённый кошелёк Monero, добавить ещё один нельзя. В диалоге создания вариант Monero будет недоступен, а переключатель на карточке отключённого кошелька — заблокирован; в обоих случаях панель подскажет причину.
Что из этого следует на практике:
- Сменить кошелёк можно только через отключение: выключите переключатель на карточке текущего кошелька, после этого станет доступно создание нового.
- Второй мерчант на том же сервере свой кошелёк Monero завести не сможет — в списке его валют Monero не появится. Если Monero нужен нескольким мерчантам с раздельным учётом денег, для этого нужен отдельный сервер.
Шаг 2. Выберите ноду
Блоки сети панель получает через ноду Monero. По умолчанию используется публичная нода — специально настраивать ничего не нужно, приём работает сразу после добавления кошелька. Это штатный режим, а не временное решение: оставаться на публичной ноде можно сколько угодно.
Если вы держите собственную ноду Monero, подключите её: QryptoPay → «Настройки» → «Ноды» → строка Monero → «Подключить свою ноду». Адрес вашей ноды указывается в поле «Адрес». Поля «Имя пользователя» и «Пароль» нужны, только если нода закрыта логином (monerod --rpc-login) — обычно нода стоит в закрытой сети, и поля остаются пустыми. Вернуться на публичную можно там же, кнопкой «Отключить свою ноду» — приём при этом не останавливается.
На той же странице под каждой сетью видно, успевает ли панель за сетью. Если по Monero появилось предупреждение, начните со смены ноды — а если и публичная не помогла, см. Мониторинг состояния QryptoPay.
Шаг 3. Проверьте приём тестовым платежом
Тестовый терминал для этого не подойдёт: он не работает с реальными сетями, и кошельки ему не нужны. Проверка идёт на основном терминале и требует настоящего перевода — берите минимальную сумму.
- Сформируйте платёжную ссылку из своего магазина и откройте её.
- Выберите Monero среди способов оплаты. Если его нет в списке — проверьте позицию лицензии и то, что кошелёк включён.
- Переведите указанную сумму на адрес со страницы оплаты, из своего приложения для Monero.
- Дождитесь подтверждений: платёж засчитывается после 10 подтверждений сети, это примерно 20 минут. Счётчик виден покупателю прямо на странице оплаты.
- Убедитесь, что магазин получил уведомление на вебхук, а платёж появился у мерчанта на вкладке «Платежи».
Дошли деньги и уведомление — приём Monero настроен.
Что панель по Monero не покажет
- Отправителя платежа. Сеть Monero не раскрывает, с какого адреса пришли деньги, — ни панели, ни обозревателю блокчейна. Поэтому связать поступление с покупателем можно только по данным, которые ваш магазин передал при создании платежа: у платежа, пришедшего без счёта, покупатель останется неизвестным.
- Кнопку «Обновить балансы». Для Monero её нет — пересчитывать нечего, панель и так получает баланс из сети.
- Баланс отключённого кошелька. Карточка остаётся пустой, пока вы не включите кошелёк обратно; деньги при этом никуда не деваются.
- Операции по кошельку. В журнале операций Monero не появляется: выплат, сбора средств и переводов комиссии здесь не бывает.
- Приход до подключения кошелька — см. предупреждение выше.
Что дальше
- Управление кошельками — баланс, включение, отключение и удаление кошелька.
- Как добавить кошелёк в QryptoPay — ключи для остальных сетей.
- Настройка комиссий для валют в QryptoPay — комиссия за оплату, в том числе для Monero.
- Мониторинг состояния QryptoPay — узнавайте о сбое раньше покупателей.