Мерчант EVM Native

Инструкция по настройке мерчанта EVM Native

1

Описание

Модуль позволяет принимать нативные токены EVM-сетей, например ETH, BNB, MATIC, AVAX и другие, через собственную ноду.

Глоссарий

• Прокси-адрес - адрес для депозита нативной валюты EVM-сети, сгенерированный для заявки. На данный адрес клиент будет отправлять нативную валюту EVM-сети для оплаты заявки.

  • Одноразовый прокси-адрес - адрес для депозита нативной валюты EVM-сети, сгенерированный для одной конкретной заявки. Такой адрес будет навсегда закреплен за заявкой и не будет повторно использоваться для других заявок.

  • Переиспользуемый прокси-адрес - адрес для депозита нативной валюты EVM-сети, сгенерированный для заявки. Такой адрес будет временно закреплен за заявкой и будет повторно использован для одной из следующих заявок через то количество дней, которое указано в настройках мерчанта.

• Мастер-адрес - адрес кошелька на который будет отправляться нативная валюта EVM-сети при сборе средств с прокси-адреса. Обычно это адрес вашего холодного/горячего кошелька, к примеру, можно использовать адрес, который вы сгенерировали и храните в аппаратном кошельке Ledger.

Сбор средств

При использовании AML-модуля на прием, сбор средств не будет запущен если AML-модуль установит для заявки статус Удержана.

Сбор нативной валюты с прокси-адреса на мастер-адрес выполняется мерчантом автоматически. Комиссия сети за перевод оплачивается из баланса нативной валюты на прокси-адресе.

2

Установка мерчанта

Используя параметры ниже, установите мерчант через функционал "Install plugin" по инструкции Install plugin.

Параметры для Install Plugin

Plugin type: Merchant module

Plugin URL: @boxexchanger-plugins/merchant-evm-native

Directory path: evm-native

Auth: (Deploy token): оставляем пустым

Package tag: latest

Обратите внимание, один мерчант поддерживает только одну нативную валюту EVM-сети. Для того чтобы принимать через мерчант EVM Native более одной нативной валюты, необходимо дублировать мерчант через функционал Install Plugin (при установке необходимо указывать уникальный Directory Path). Если у вас возникнут вопросы - вы всегда можете обратиться в поддержку BoxExchanger.

3

Настройка мерчанта

Использование публичных нод недоступно.

Для настройки мерчанта вам необходима собственная нода EVM-совместимой сети (Ethereum, BSC, Polygon, Arbitrum и т.п). Мануал по установке ноды: Ethereum Node

Также подойдет сервис, который предоставляет доступ к собственным нодам, например, Quicknode.

1. В админ панели скрипта перейдите на страницу "Мерчант и API" -> в разделе "Merchant system" нажмите на значок настройки в блоке мерчанта "EVM native".

1. На странице настроек мерчанта в поле "RPC node URL" укажите ссылку на ноду -> нажмите "Save".

2. В поле "Synced blocks" укажите "0" (рекомендуется) чтобы подтянулся последний замайненный блок в блокчейне либо укажите номер блока, с которого будет начинаться синхронизация -> нажмите "Save".

3. Для поля "Payment with QR-code?" выберите значение "Yes" для того чтобы на шаге оплаты заявки отображался QR-код с адресом для депозита, или No чтобы QR-код не отображался -> нажмите "Save".

4. В поле "Wait confirms blocks" укажите необходимое количество блоков для подтверждения транзакции. Рекомендуем устанавливать 12-> нажмите "Save".

К примеру, если в поле "Wait confirms blocks" будет установлено значение 12, то статус заявки будет изменен На выплатутолько после того как транзакция на прокси-адрес наберет 12 подтверждений сети в блокчейне.

1. В поле "Limit blocks per request" укажите количество блоков, которое будет обрабатываться за один API-запрос. Рекомендуется оставить 50.

2. В поле "Re-use address after" укажите через какое количество дней прокси-адрес будет использован повторно для другой заявки

   1. Укажите значение 36500 для того чтобы прокси-адрес не использовался повторно для других заявок.

   2. Либо установите количество дней через которое прокси-адрес будет использован повторно для другой заявки.

   -> нажмите "Save".

3. В поле "Gas price (in gwei) or auto" укажите:

   1. Значение "Auto" (Рекомендуется) для того чтобы цена газа высчитывалась автоматически в зависимости от нагрузки сети.

   2. Конкретное значение цены газа, которое вам удобно. Однако, необходимо учитывать что при низкой цене газа может не произойти сбор средств с прокси-адреса на мастер-адрес.

   -> нажмите "Save".

4. В поле "Minimum payment amount to process" укажите минимальную сумму поступившего платежа, при которой мерчант может запустить сбор нативной валюты. Если поступившая сумма меньше указанного значения, мерчант не будет выполнять сбор.

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

1. В поле "Collect token when amount greater than or equal" укажите минимальный баланс нативной валюты на прокси-адресе, при котором выполняется сбор -> нажмите "Save".

2. В поле "Master address" укажите адрес кошелька, на который будет происходить сбор средств с прокси-адресов -> нажмите "Save".

3. Мерчант настроен, вы можете установить его в качестве модуля приема в валюте/направлении и принимать нативные токены EVM-сетей.