Организации

Организация — это отдельный проект/площадка со своими кошельками, сетями и настройками. У каждой организации есть уникальный идентификатор (ID организации), который виден в карточке.

Создать организацию

1. Перейдите в раздел Organizations.
2. Нажмите + ADD и задайте название.

Чтобы открыть настройки — кликните по карточке организации. Внутри доступны вкладки: General, Networks, AML, Coins, API keys.

Info

Большинство чувствительных полей (ключи, приватные ключи кошельков) скрыты по умолчанию — отображаются как звёздочки. Чтобы задать или изменить значение, нажмите EDIT рядом с полем.

General

На вкладке General настраиваются базовые параметры организации:

• Name — отображаемое название организации (до 64 символов).
• Webhook URL — адрес, на который платформа отправляет уведомления о событиях (например, об успешном или отклонённом платеже). Укажите адрес, на котором ваш сайт/сервис принимает уведомления.

Networks

На вкладке Networks вы настраиваете каждую блокчейн-сеть, в которой хотите принимать платежи. Сети представлены отдельными вкладками: TRC20, BEP20, ERC20, TON, ARBITRUM.

Для каждой сети есть блоки настроек. Набор полей зависит от сети — например, блок Energy settings есть только для TRC20.

Блок General (кошельки сети)

• Admin wallet address — ваша постоянная (основная) адреса в этой сети. Именно сюда платформа переводит средства после успешной AML-проверки, и отсюда вы выводите деньги на биржу или внешний кошелёк.
• Hot wallet private key — настройка «горячего» кошелька. Он нужен, чтобы каждый платёж сначала принимался на отдельный одноразовый адрес, а после AML-проверки автоматически переводился на основной кошелёк. Все ключи вы задаёте самостоятельно.

Info

Из соображений безопасности приватный ключ горячего кошелька после сохранения отображается скрытым (звёздочками). Чтобы заменить его, нажмите EDIT и введите новый.

Блок Energy settings (TRC20)

Для переводов в сети Tron нужна энергия. Доступны два провайдера аренды энергии — выберите один:

• Netts
• ITRX

Для выбранного провайдера укажите:

• API key;
• Secret API.

Блок AML settings (для этой сети)

• Enable AML — переключатель проверки входящих платежей в этой сети.
• AML Provider — поставщик AML-проверок: BitOK или AMLBot (зависит от сети).
• Max risk score (%) — верхняя граница общего риска (для TRC20 и подобных сетей).
• Max high-risk signals (%) — верхняя граница количества сигналов высокого риска.
• Max AML risk level — порог, до которого платёж считается допустимым. Доступные уровни: low, medium, high, critical.
• Block on blacklist — если включено, платёж с адреса из чёрного списка будет заблокирован независимо от других показателей.

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

Warning

Ни один из провайдеров AML-проверок на данный момент не поддерживает проверку для сети TON.

Для провайдера BitOK набор полей AML упрощён — доступны только переключатель AML, провайдер и max risk level.

Info

Чем строже порог (например, «low»), тем меньше «рискованных» платежей пройдёт автоматически. Адреса из белого списка AML пропускаются без проверки.

AML

На вкладке AML указываются учётные данные AML-провайдеров на уровне организации. Платформа поддерживает два провайдера — ключи для каждого задаются отдельно:

BitOK:

• API key;
• Secret API.

AMLBot:

• Access ID;
• Access key.

Ключи AMLBot берутся на web.amlbot.com → Profile → API keys.

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

Coins

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

• Hub organization ID;
• Hub deposit API key;
• Hub withdrawal API key;
• Hub webhook secret.

Заполните все четыре поля — они работают в связке. После сохранения для организации становится доступен Coins-кошелёк.

Info

Комиссия. При зачислении средств через Coins удерживается комиссия 0.2% от суммы, но не менее 0.5 USDT.

Когда средства поступают через Coins, в разделе Адреса в колонке Balance отображается конвертация — например, 5 XRP → 5.56 ₮.

API keys

Вкладка API keys нужна для интеграции приёма платежей в ваш сайт или сервис. Здесь вы видите:

• Organization UID — уникальный идентификатор вашей организации;
• Webhook key — используется для проверки подлинности уведомлений, которые платформа отправляет на ваш webhook URL;
• API key — секретный ключ для обращений к API; можно выполнить перегенерацию

Warning

Важно о перегенерации. Новый API key показывается один раз сразу после генерации — скопируйте и сохраните его. Старый ключ при этом перестаёт работать, поэтому обновите его во всех интеграциях.

Если в вашем профиле включена 2FA (TOTP), для перегенерации API key потребуется ввести одноразовый код из приложения-аутентификатора.

Белый список IP API key

В нижней части вкладки — API key IP whitelist:

• если список пуст — API доступен с любой IP-адреса;
• если добавлена одна или несколько IP — запросы к API принимаются только с этих адресов.

Нажмите + ADD, чтобы внести IP-адрес сервера, с которого работает ваша интеграция.

Зачем это нужно. С этими данными ваша внешняя система может автоматически:

• генерировать одноразовые адреса под каждую заявку клиента;
• запрашивать баланс;
• инициировать выводы и проверять их статус.

То есть вы либо встраиваете приём платежей в собственный сайт/обменник, либо указываете эти ключи в стороннем сервисе (например, в модуле криптообменника), который будет работать с платформой от вашего имени.

Депозит под последующую выплату монеты

POST /generate-disposable-address принимает необязательное поле payout_token_ticker — тикер монеты, которую вы затем выплатите из этого депозита.

• Поле не передано или пустое: адрес остаётся обычным. main_address_type по умолчанию MAIN. Стейблкоины горячего кошелька идут ончейн: USDT и USDC в TRC20, BEP20 и ARBITRUM; USDT, USDC, DAI, USDS и PYUSD в ERC20; USDT в TON.
• Поле передано, но тикера нет среди известных монет (любая сеть): поле игнорируется, адрес остаётся обычным. Новая монета при этом не создаётся. Так же для фиата, например UAH.
• Если тикер известен, адрес создаётся как Coins, даже когда main_address_type не передан или равен MAIN. Депозит зачисляется на виртуальный баланс USDT, чтобы последующая выплата могла его потратить.

Выплата из этого депозита передаёт source_order_id, равный order_id депозитного адреса. Тогда и стейблкоин горячего кошелька списывается с виртуального баланса USDT. Отдельное type=COINS в теле выплаты не нужно: Coins выбирается, когда есть source_order_id или тикер выплаты не входит в стейблкоины горячего кошелька выше. Повторный запрос на тот же адрес с другим payout_token_ticker и тем же order_id конфликтует.