Orphan transactions
This section provides methods for receiving and withdrawing orphan transactions.
Orphan Transactions are transactions randomly sent to an address that was created for another coin.
If such a transaction is detected, you can withdraw the received coins to the specified address.
Transactions have two stages DEPOSIT and WITHDRAWAL. The output can be created when the transaction is at the DEPOSIT stage and in the PROCESSED status, there is also a parameter in the transaction body canWithdrawal which can be used when trying to output.
After the output, you will receive a webhook at the specified URL when requesting output (the body of the webhook will be identical to the body of the output). The outgoing transaction will also appear in the outTransaction field in the body of the orphan transaction
Description of transaction fields
id
Transaction ID in the system
organizationId
ID of the organization that the address belongs to
orderId
ID of the order to which the address was linked at the time the transaction was detected
stage
The current stage of the transaction. There are 2 values available: DEPOSIT and WITHDRAWAL
status
Status of the current stage of the transaction
message
Message when the operation is rejected
currency
Transaction Coin
network
Transaction Network
amount
Transaction amount
canWithdrawal
Is coin withdrawal available. (Available only at the DEPOSIT stage and in the PROCESSED status)
inTransaction
Incoming transaction data
outTransaction
Data of the outgoing transaction if a withdrawal was requested
createdAt
Date of transaction discovery
Incoming transaction:
addressType
The type of address the transaction came to
addressID
ID of the address in the system
address
Address in the blockchain
txId
Transaction ID in the blockchain
amount
Transaction amount
status
Transaction status
createdAt
Date of the transaction
Outgoing transaction transaction:
address
Address in the blockchain
txId
Transaction ID in the blockchain
amount
Transaction amount
status
Transaction status
feeAmount
Network commission per transaction
feeAmountUSD
The network's commission per transaction in terms of USD
withdrawalId
ID of the output in the system
createdAt
Date of creation of the withdrawal request
Description of the addressType field:
PAY_IN
Address for payments
PAY_OUT
Payment address
BUSINESS
Business wallet
RECURRENT
Address for recurrent payments
PERSONAL
Personal address
Description of the status field:
init
The transaction was created in the system
processed
Successfully processed
error
Error during processing
rejected
Rejected by the system
pending
During processing
Transaction stages:
DEPOSIT
A deposit has been received, for withdrawal it is necessary to wait for the transition to the status of PROCESSED
WITHDRAWAL
Withdrawal of received coins was requested.
Transaction statuses:
PENDING
The operation is in progress. For the DEPOSIT stage, waiting for incoming transaction confirmations. For the WITHDRAWAL stage - waiting for the transaction to be sent to the blockchain
PROCESSED
The operation was completed successfully. For the DEPOSIT stage, the incoming transaction is confirmed. For the WITHDRAWAL stage, the transaction has been successfully sent
ERROR
Error processing the operation
REJECTED
Operation rejected
Commission token
To request a commission token, you must specify the orphan transit ID. The token is generated for the amount that came to the address in full volume.
currency
Withdrawal Coin
network
Output Network
feeSource
The source of the commission write-off. There are 2 values available: ADDRESS, ADVANCE
blockchainFee
Network commission in the transaction coin
blockchainFeeUSD
The network's commission in terms of USD
serviceFee
Service commission
serviceFeeUSD
Service fee in USD
amount
Withdrawal amount
amountTo
The amount that the outgoing address will receive after withdrawal (minus fees for feeSource: ADDRESS)
price
The conversion rate of the network commission to USD
token
Withdrawal Token
expiresAt
Token expiration date
Description of the feeSource field:
ADDRESS
The source of the network's withdrawal fee is the address. In this case, blockchainFee will be taken from the withdrawal amount, so the amount and amountTo fields will be different.
ADVANCE
The source of the deduction of the network's commission for withdrawal is the advance balance. In this case, blockchainFeeUSD + blockchainFeeUSD will be debited from the advance balance.
Last updated