Сиротские транзакции
В этом разделе представлены методы для получения и вывода сиротских транзакций.
Сиротские транзакции - это транзакции случайно отправленный на адрес, который был создан для другой монеты.
При обнаружении такой транзакции вы можете вывести полученные монеты на указанный адрес.
У транзакций есть две стадии 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.
Last updated