Check and Detect incoming deposits
Reminder
- Before deposits are accepted, the deposit account needs to be protected with a strong passphrase and protected with a public key.
- The use of throwaway addresses is discouraged.
To monitor an account for incoming deposits, use the getAccountTransactions API call with the following request parameters.
We recommend you to access the Node HTTP API Documentation and get more information about this API call. You can access by clicking the following link: http://localhost:6876/api-doc/index.html#get-/api-requestType-getAccountTransactions
Generally, pending deposits are those deposits contained within the getAccountTransactions API call that do not meet the requirements to be credited to customer accounts. These amounts can be displayed as pending until the transactions appear with the required number of confirmations in a subsequent API call response.
Deposits can be credited to a customer’s account after any number of confirmations, but crediting transactions immediately is not recommended. For security puposes, is recommended that the number of confirmations is set to a minimum of 10.
Each transaction contains a deadline after which the transaction will be canceled if it is not included in a block. This deadline will always be either a default of 24 hours or a custom deadline set by the transaction’s initiator. To avoid complication from a transaction being canceled if its block is orphaned and its custom deadline is too short to assure that it is reincluded, further conditions based on the transaction’s timestamp and deadline parameters are recommended (either for all transactions or conditioned upon the amount of the transaction according to risk management strategy).
The shorter recommendation of 10 confirmations is appropriate for transactions that have the default deadline of 24 hours. These transactions are automatically reincluded in the event of a blockchain reorganization. The longer recommendation of 1,440 blocks, the maximum depth of a blockchain reorganization, is appropriate for transactions with a custom deadline that is less than 24 hours. After 1,440 confirmations, no combination of deadline and blockchain reorganization can cause a transaction to be canceled.