Как добавить первый кошелёк для приёма платежей

Эта статья — продолжение QryptoPay. Быстрый старт. Модуль установлен, мерчант создан — теперь расскажем, как настроить, куда будут приходить деньги ваших клиентов.

Адреса, на которые платят клиенты, QryptoPay генерирует из вашего кошелька — пока кошелька нет, выдать клиенту адрес для оплаты модулю не из чего.

Почему лучше начать с Ethereum

Бесплатная лицензия QryptoPay включает лимит платежей и приём в сети Ethereum, так что первый кошелёк логично сделать именно в этой криптовалюте — приём заработает без покупки лицензий.

ℹ️ Что именно бесплатно

Бесплатно принимается нативный ETH. Стейблкоины USDT и USDC в сети Ethereum, а также Tron, Bitcoin и Litecoin — отдельные позиции лицензии: добавленный ethereum-кошелёк сам по себе не включит приём USDT.

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

Деньги на нём не задерживаются: собранные с клиентов средства QryptoPay сам переводит на ваш основной кошелёк — его вы укажете в поле «Кошелёк для выплат».

⚠️ Важно

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

Создание кошелька в TrustWallet

Кошелёк можно создать в любом приложении или сервисе, которому вы доверяете, — ниже пример на TrustWallet:

1. Установите приложение из официального магазина приложений.
2. Создайте новый кошелёк — не импортируйте существующий.
3. Запишите секретную фразу (12 слов) и сохраните её офлайн: на бумаге или в менеджере паролей. Это единственный способ восстановить доступ к кошельку.
4. Не переводите на этот кошелёк свои средства — он нужен только как промежуточный для приёма платежей.

💡 Совет

Названия пунктов меню в мобильных приложениях меняются от версии к версии. Если подписи в вашей версии отличаются, ориентируйтесь на смысл шага — «создать новый кошелёк» и «сохранить секретную фразу».

Заодно подготовьте второй кошелёк — для выплат: именно на него QryptoPay будет переводить собранные с клиентов деньги, и именно он должен быть надёжным. Подойдёт ваш существующий кошелёк — например, аппаратный Ledger или любой другой, которым вы уже пользуетесь. Если такого нет, создайте в TrustWallet второй кошелёк и держите его отдельно от того, ключ которого вы отдадите панели. Понадобится только его адрес — приватный ключ кошелька для выплат панели не нужен.

Приватный ключ для панели

Панели нужен не ключ отдельного адреса, а Account Extended Private Key — ключ уровня аккаунта, из которого генерируются адреса для ваших клиентов. TrustWallet его не показывает, поэтому ключ получают из секретной фразы:

• откройте https://iancoleman.io/bip39/;
• (настоятельно рекомендуется) полностью отключите компьютер от сети;
• введите секретную фразу в поле BIP39 Mnemonic;
• в списке Coin выберите ETH;
• в разделе Derivation Path перейдите на вкладку BIP44;
• скопируйте Account Extended Private Key и сохраните локально;
• закройте вкладку и восстановите подключение к интернету.

⚠️ Важно

Нужно именно длинное значение Account Extended Private Key из блока BIP44, а не короткий Private Key из таблицы производных адресов внизу страницы.

Заодно скопируйте первый адрес (индекс 0) из таблицы производных адресов — он понадобится, чтобы проверить ключ при сохранении.

Подробный разбор этого шага и ключи для остальных сетей — в статье Как добавить кошелёк в QryptoPay.

Добавление кошелька в панели

Откройте QryptoPay → Обзор → Последние кошельки → «Добавить кошелёк» и заполните поля:

• Имя — любое удобное название, от 2 до 64 символов;
• Блокчейн — ETH;
• Приватный ключ — скопированный Account Extended Private Key;
• Кошелёк для выплат — адрес того самого надёжного кошелька, который вы подготовили заранее; он должен быть в том же блокчейне;
• Порог выплаты — сумма в USD, начиная с которой собранные средства уходят на кошелёк для выплат. Значение 0.00 означает, что деньги отправляются сразу, не дожидаясь накопления;
• Порог резерва для комиссий сети — сумма в USD, которую нужно оставлять на кошельке для оплаты комиссий сети при выводе. Для Ethereum панель подсказывает 25 — этого хватает на первое время;
• Почта для уведомлений — адрес электронной почты для писем о состоянии кошелька.

В блоке «Уведомления на почту» стоит включить всё: «Заканчивается резерв для комиссий сети», «Исчерпан резерв для комиссий сети», «Не удалось активировать адрес» и «Обнаружены неучтённые поступления». Так вы узнаете о проблеме с приёмом раньше, чем о ней сообщит клиент.

💡 Совет

Перед сохранением нажмите «Проверить ключ» и введите в поле «Основной адрес» первый адрес вашего кошелька. Ответ «Ключ соответствует этому адресу» подтверждает, что ключ скопирован верно; «Для этого адреса нужен другой ключ» означает, что вы взяли не то значение.

ℹ️ Примечание

Кошелёк добавляется только для основного терминала. Тестовому терминалу кошельки не нужны — платежи через него не требуют реального перевода криптовалюты.

После сохранения модуль готов принимать оплату в выбранной сети. Балансы, запас на комиссии, отключение и удаление кошелька — в статье Управление кошельками.

Следующий шаг

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

• Настройка платёжной страницы QryptoPay — домен, SSL и логотип на странице оплаты.