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