Выплаты 2.0

Выплаты 2.0 позволяют производить выводы с выплатных и головных адресов.

Возможности:

• прямой вывод

• вывод между сетями

• вывод с конвертацией монет

Подбор адреса

Для проведения операции подбирается наиболее подходящий адрес

Пример подбора адреса:

У вас есть несколько адресов

Монета	Сеть	Баланс	Эквивалент
USDT	tron	100	..
USDT	ethereum	100	..
BNB	bsc	100	..

• Вы хотите вывести 10 USDT tron

  • Прямой вывод. Будет взят адрес USDT tron так как у вас уже есть адрес с этом монетой и в этой сети, и на нем достаточно средств

• Вы хотите вывести 10 BNB bsc

  • Прямой вывод. Будет взят адрес BNB bsc так как у вас уже есть адрес с этом монетой и в этой сети, и на нем достаточно средств

• Вы хотите вывести 10 USDT bsc

  • Вывод между сетями. Будет взят адрес USDT tron так как подходящего адреса у вас нет

• Вы хотите вывести 1 BTC bitcoin

  • Вывод с конвертацией монет. Будет взят адрес USDT tron так как подходящего адреса у вас нет

Обратите внимание

Операции вывод между сетями и вывод с конвертацией монет работают только с адресами токенов (USDT, USDC) Адреса нативных монет будут браться только для прямого вывода

Адрес берется среди всех PAY_OUT (выплатные) и COLLECT (головные) адресов. Ищется адрес с балансом покрывающим запрошенную сумму и с наиболее низкой комиссией сети. Приоритет операций: вывод, вывод между сетями, вывод с конвертацией монет.

Комиссии

При проведении операции будет взят тариф в зависимости от типа операции

Тип операции	Тариф
Прямой вывод	Вывод с выплатного баланса
Вывод между сетями	Блокчейн мост API
Вывод с конвертацией монет	Обмен API

Операции вывод между сетями, вывод с конвертацией монет проводятся через провайдера услуг, комиссия сети за отправку монет провайдеру компенсируется сервисом

Комиссия сервиса за операцию всегда берется с авансового баланса

Комиссия сети за отправку от провайдера взимается из суммы если исходящая нативная монета, с авансового баланса если исходящая монета является токеном

Параметр feeInAmount

Параметр позволяет указать, что комиссия сети за отправку монет от провайдера на конечный адрес будет взята из суммы (пользователь получит сумму меньше указанной на размер комиссии сети)

Если исходящая монета нативная, и указан параметр feeInAmount=false, то комиссия сети будет добавлена к сумме, чтобы пользователь получил указанную сумму

Описание полей

В ответ на запрос придет тело со следующими полями

Имя	Тип	Описание
id	string	Идентификатор операции
organizationId	string	Идентификатор организации
type	enum(WITHDRAWAL, BRIDGE, SWAP)	Тип
status	enum(PENDING, WITHDRAWING, PROCESSED, REJECTED, ERROR)	Статус
message	string or null	Сообщение при отклонении
addressRiskLevel	enum(Low, Medium, High, Severe) or null	Уровень риска конечного адреса
addressFromId	string	Идентификатор исходящего адреса
addressFrom	string	Исходящий адрес
addressTo	string	Конечный адрес
amountFrom	string	Исходящая сумма
amountFromUSD	string	Исходящая сумма в USD
amountTo	string	Сумма после операции
amountToUSD	string	Сумма после операции в USD
amountToReceive	string	Сумма, которая придет на конечный адрес
amountToReceiveUSD	string	Сумма, которая придет на конечный адрес в USD
rate	string	Курс обмена
blockchainFeeFrom	string	Комиссия сети за отправку провайдеру
blockchainFeeFromUSD	string	Комиссия сети за отправку провайдеру в USD
blockchainFeeToSource	enum(ADVANCED, AMOUNT)	Источник списания комиссии сети за отправку от провайдера на конечный адрес
blockchainFeeTo	string	Комиссии сети за отправку от провайдера на конечный адрес
blockchainFeeToUSD	string	Комиссии сети за отправку от провайдера на конечный адрес в USD
serviceFee	string	Комиссия сервиса за проведение операции
webhookUrl	string or null	URL для отправки вебхука
txId	string or null	Хэш транзакции отправки монет на конечный адрес
createdAt	string (Date in ISO 8601)	Дата создания
updatedAt	string (Date in ISO 8601)	Дата последнего обновления

---

Поле type

Имя	Описание
WITHDRAWAL	Обмен
BRIDGE	Обмен между сетями
SWAP	Обмен с конвертацией монет

---

Поле status

Имя	Описание
PENDING	В процессе обработки
WITHDRAWING	В процессе отправки на конечный адрес
PROCESSED	Завершен с успехом
REJECTED	Отклонен системой
ERROR	Ошибка при обработке

---

Поле blockchainFeeToSource

Имя	Описание
ADVANCED	Авансовый баланс
AMOUNT	Сумма

---

Пример тела ответа

{
  "success": true,
  "response": {
    "id": "31a3b86b-e350-4906-9d3e-cc2fca054821",
    "organizationId": "1f07eb01-5fd8-4e05-89b5-bebcd1d1fc39",
    "userId": null,
    "type": "WITHDRAWAL",
    "status": "PENDING",
    "message": null,
    "addressRiskLevel": "Low",
    "addressFromId": "25a8de42-a359-47f1-bb82-bc9f6c20f1b9",
    "addressFrom": "0xD65D24ABCd85165a243C33Cf8133ffBaaa98255D",
    "addressTo": "0x22aECc7ff5b435E38be5457C8538256918783F67",
    "amountFrom": "3",
    "amountFromUSD": "3.00",
    "amountTo": "3",
    "amountToUSD": "3.00",
    "amountToReceive": "3",
    "amountToReceiveUSD": "3.00",
    "rate": "0",
    "blockchainFeeFrom": "0",
    "blockchainFeeFromUSD": "0",
    "blockchainFeeToSource": "ADVANCED",
    "blockchainFeeTo": "0.12",
    "blockchainFeeToUSD": "0.12",
    "serviceFee": "0.09",
    "webhookUrl": "https://example.com/webhook-url",
    "txId": null,
    "createdAt": "2024-09-09T15:43:32.986Z",
    "updatedAt": "2024-09-09T15:43:34.073Z"
  }
}

Webhook

При смене статуса операции будет отправлен вебхук на указанный URL

Пример тела вебхука

{
  "id": "31a3b86b-e350-4906-9d3e-cc2fca054821",
  "organizationId": "1f07eb01-5fd8-4e05-89b5-bebcd1d1fc39",
  "userId": null,
  "type": "WITHDRAWAL",
  "status": "PENDING",
  "message": null,
  "addressRiskLevel": "Low",
  "addressFromId": "25a8de42-a359-47f1-bb82-bc9f6c20f1b9",
  "addressFrom": "0xD65D24ABCd85165a243C33Cf8133ffBaaa98255D",
  "addressTo": "0x22aECc7ff5b435E38be5457C8538256918783F67",
  "amountFrom": "3",
  "amountFromUSD": "3.00",
  "amountTo": "3",
  "amountToUSD": "3.00",
  "amountToReceive": "3",
  "amountToReceiveUSD": "3.00",
  "rate": "0",
  "blockchainFeeFrom": "0",
  "blockchainFeeFromUSD": "0",
  "blockchainFeeToSource": "ADVANCED",
  "blockchainFeeTo": "0.12",
  "blockchainFeeToUSD": "0.12",
  "serviceFee": "0.09",
  "webhookUrl": "https://example.com/webhook-url",
  "txId": null,
  "createdAt": "2024-09-09T15:43:32.986Z",
  "updatedAt": "2024-09-09T15:43:34.073Z"
}