# 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 | Field | Description | | ---------------- | --------------------------------------------------------------------------------------------------- | | `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: | Field | Description | | ------------- | ------------------------------------------- | | `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: | Field | Description | | -------------- | -------------------------------------------------------- | | `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: | Value | Description | | ----------- | ------------------------------ | | `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: | Value | Description | | ----------- | ----------------------------------------- | | `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: | Stage | Description | | ------------ | ------------------------------------------------------------------------------------------------------------------- | | `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: | Status | Description | | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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. | Field | Description | | ------------------ | -------------------------------------------------------------------------------------------------------- | | `currency` | Withdrawal Coin | | `network` | Withdrawal 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: | Value | Description | | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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. | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.onchainpay.io/api-reference/orphans.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.