Перейти к содержимому
Запросить демоСвязаться
Связаться
← Назад к документации

Подключение мерчантов

Мерчант — это связка платформы с вашими платёжными реквизитами: криптокошельком, счётом платёжной системы или платёжным шлюзом. Через мерчантов обменник принимает средства от клиентов и выполняет выплаты. Здесь — как подключать мерчантов и проверять их работу.

Что такое мерчант в платформе

Мерчант привязывает конкретные реквизиты (ваши собственные кошельки и счета) к валюте и роли в обмене:

  • Приём средств (merchant_in) — адреса/счета, на которые клиенты отправляют оплату по заявкам.
  • Выплата (merchant_out) — кошельки/счета, с которых выполняются выплаты клиентам (вручную или автовыплатой).

Один и тот же кошелёк может быть мерчантом приёма для одних направлений и мерчантом выплаты для других.

Подключение: пошагово

  1. В панели управления перейдите в раздел «Мерчанты».
  2. Нажмите «Добавить мерчант» и выберите тип: криптокошелёк, платёжная система, шлюз.
  3. Заполните реквизиты:

merchant_type   = crypto_wallet
currency        = USDT
network         = TRC20
address         = TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
api_key         = …            # если мерчант управляется через API шлюза
role            = in | out | both

  1. Привяжите мерчанта к валютам и направлениям, где он будет использоваться.
  2. Сохраните и запустите диагностику (см. ниже).

Рекомендации:

  • Используйте отдельные кошельки под платформу, а не личные (см. Основы безопасности).
  • На одну валюту можно подключить несколько мерчантов — для разделения потоков и резервирования.
  • Для направлений с автовыплатой мерчант выплаты должен поддерживать отправку через API.

Диагностика

После подключения проверьте мерчанта:

  • Баланс — панель показывает актуальный баланс реквизитов; сверьте с фактическим.
  • Журнал транзакций — входящие и исходящие операции мерчанта, статусы, хэши транзакций.
  • Тестовый платёж — отправьте небольшую сумму на адрес приёма и убедитесь, что платформа увидела зачисление (валюта, сеть, подтверждения).
  • Статусы ошибок — типовые причины сбоев:

invalid_address      # реквизиты указаны с ошибкой / другая сеть
insufficient_balance # недостаточно средств для выплаты
api_unauthorized     # ключ API отклонён (права, срок действия)
network_mismatch     # платёж пришёл не в той сети
low_confirmations    # транзакция есть, но подтверждений меньше порога

Эксплуатация

  • Следите за балансами мерчантов выплаты: при падении ниже рабочего объёма направления встанут или уйдут в ручной режим.
  • Настройте уведомления о низком балансе и ошибках транзакций (см. Уведомления).
  • Периодически сверяйте журнал мерчанта с финансовой статистикой обменника.

См. также