Сиротские транзакции

В этом разделе представлены методы для получения и вывода сиротских транзакций.

Сиротские транзакции - это транзакции случайно отправленный на адрес, который был создан для другой монеты.

При обнаружении такой транзакции вы можете вывести полученные монеты на указанный адрес. У транзакций есть две стадии DEPOSIT и WITHDRAWAL. Вывод можно создать когда транзакция находиться на стадии DEPOSIT и в статусе PROCESSED, так же в теле транзакции есть параметр canWithdrawal на который можно ориентироваться при попытке вывода.

После вывода вам придет вебхук на указанный URL при запросе вывода (тело вебхука будет идентично телу вывода). Так же в теле сиротской транзакции появится исходящая транзакция в поле outTransaction

Описание полей транзакции

Поле	Описание
id	Идентификатор транзакции в системе
organizationId	Идентификатор организации, которой принадлежит адрес
orderId	Идентификатор ордера, к которому был привязан адрес в момент обнаружения транзакции
stage	Текущая стадия транзакции. Доступно 2 значени: DEPOSIT и WITHDRAWAL
status	Статус текущей стадии тразакции
message	Сообщение при отклонении операции
currency	Монета транзакции
network	Сеть транзакции
amount	Сумма транзакции
canWithdrawal	Доступен ли вывод монет. (Доступно только на стадии DEPOSIT и в статусе PROCESSED)
inTransaction	Данные входящей транзакции
outTransaction	Данные исходящей транзакции если был запрошен вывод
createdAt	Дата обноружения транзакции

---

Входящая тразакция:

Поле	Описание
addressType	Тип адреса, на который пришла транзакция
addressId	Идентификатор адреса в системе
address	Адрес в блокчейне
txId	Идентификатор транзакции в блокчейне
amount	Сумма транзакции
status	Статус транзакции
createdAt	Дата обнарущения транзакции

Исходящая тразакция тразакция:

Поле	Описание
address	Адрес в блокчейне
txId	Идентификатор транзакции в блокчейне
amount	Сумма транзакции
status	Статус транзакции
feeAmount	Комиссия сети за транзакцию
feeAmountUSD	Комиссия сети за транзакцию в пересчете к USD
withdrawalId	Идентификатор вывода в системе
createdAt	Дата создания запроса на вывод

---

Описание поля addressType:

Значение	Описание
PAY_IN	Адрес для платежей
PAY_OUT	Выплатной адрес
BUSINESS	Бизнек кошелек
RECURRENT	Адрес для рекуррентных платежей
PERSONAL	Персональный адрес

Описание поля status:

Значение	Описание
init	Транзакция была создана в системе
processed	Успешно обработана
error	Ошибка в процессе обработки
rejected	Отклонена системой
pending	В процессе обработки

---

Стадии транзакции:

Стадия	Описание
DEPOSIT	Был получен депозит, для вывода необходимо дождаться перехода в статус PROCESSED
WITHDRAWAL	Был запрошен вывод полученных монет.

---

Статусы транзакции:

Статус	Описание
PENDING	Операция в процессе исполнения. Для стадии DEPOSIT - ожидание подтверждений входящей транзакции. Для стадии WITHDRAWAL - ожидание отправки транзакции в блокчейн
PROCESSED	Операция успешно исполнена. Для стадии DEPOSIT - входящая транзакция подтверждена. Для стадии WITHDRAWAL - транзакция успешно отправлена
ERROR	Ошибка при обработке операции
REJECTED	Операция отклонена

Токен комиссии

Для запроса токена комиссии необходимо указать идентификатор сиротской транзкции. Токен формируется для сумма, которая пришла на адрес в полном обьеме.

Поле	Описание
currency	Монета вывода
network	Сеть вывода
feeSource	Источник списания комиссии. Доступно 2 значения: ADDRESS, ADVANCE
blockchainFee	Комиссия сети в монете транзакции
blockchainFeeUSD	Комиссия сети в пересчете к USD
serviceFee	Комиссия сервиса
serviceFeeUSD	Комиссия сервиса в USD
amount	Сумма вывода
amountTo	Сумма, которую получит исходящий адрес после вывода (за вычетом комиссий при feeSource: ADDRESS)
price	Курс пересчета комиссии сети к USD
token	Токена вывода
expiresAt	Дата истечения токена

---

Описание поля feeSource:

Значение	Описание
ADDRESS	Источник списания комиссии сети за вывод - адрес. В данном случае blockchainFee будет взята из суммы вывода, поэтому поля amount и amountTo будут отличаться.
ADVANCE	Источник списания комиссии сети за вывод - авансовый баланс. В данном случае с авансового баланса будет списана blockchainFeeUSD + blockchainFeeUSD.