Transaction Webhook

Aquanow offers webhook callbacks for clients that want to be updated when a transaction is detected on-chain or finalized.

Status of Transaction

Status	Description
DONE	Successfully deposited and executed.
REJECTED	Successfully deposited but no execution occurred.
AML_DECLINED	Transaction has been declined due to AML reasons.
FAILED	Transaction has been failed on the blockchain.

Webhook Payload Examples

DONE

{
  "quantity": 0.05,
  "sourceAddress": "0xEE506212EE33ac1ac66D56e9Ea5D5866e8C7168e",
  "accountId": "CA1000001R",
  "txId": "1ce309d1-e80a-47bb-a18f-affd3a87e1ba",
  "symbol": "ETH",
  "txHash": "0x954f6d87aac739cfd54804dd0b4efcd1ea7834a42e9dc3629b03ac10867933ee",
  "txTime": 1707843915401,
  "username": "helloWorld",
  "address": "0x8dCb581B1B7a7426EF5f3Bf6A7b2177BD00342F8",
  "transactionType": "DEPOSIT",
  "adminApproval": "DONE"
}

REJECTED

{
  "quantity": 0.00009989,
  "sourceAddress": "tb1qwmxjsq283elnzsd306c6h3z08fucyhl565a4s2",
  "subaccount": "deedddff",
  "txId": "e09fef5d-6ab4-4da1-bed6-5a7d6416162d",
  "symbol": "BTC",
  "txHash": "7f9e94c800079ed7ff71da6d02e16885e9ae39cb8c79473649fb00254f20fe1b",
  "txTime": 1649259696838,
  "address": "mtTu1NHfgbWQH2u4iXCfSYnohbQw1w1AJj",
  "tradeSide": "buy"
  "transactionType": "DEPOSIT",
  "username": "helloWorld",
  "adminApproval": "REJECTED"
}

AML_DECLINED

{
  "address": "mzczAqqqNqtozbaT7oJEzYML814Wg7d999",
  "adminApproval": "AML_DECLINED",
  "confirmation": 0,
  "quantity": 0.00002159,
  "sourceAddress": "tb1qx3r63vymgvp0ln5na022zzh7cv6xu3rs94g6ca",
  "subaccount": "deedddff",
  "symbol": "BTC",
  "tradeSide": "buy"
  "transactionType": "DEPOSIT",
  "txHash": "14a8cbac6973374573326ab97891c9fe13eec03143e538e1a3e92987140ab04a",
  "txId": "3e06c4eb-b134-4a93-a78f-a979e1d3a803",
  "username": "helloWorld"
}

FAILED

{
  "quantity": 1,
  "sourceAddress": "0xc08377dF1eF026aeb12dcc57D254173CB6b0A1aA",
  "txId": "dba8b6ba-cd8f-4c75-94e6-6b443dc12bd7",
  "symbol": "ETH",
  "txHash": "0xf62f9fe6c90e85792fef676ddaa711916d9abb6b6b600e3c5b1d4bdcb1a38ec1",
  "username": "deposit_test_user_wmukdf",
  "address": "0xD569F39543D05c3b4d20A23ab37a9FE4882D6a17",
  "transactionType": "DEPOSIT",
  "adminApproval": "FAILED"
}

Callback Parameter Values

Parameter	Type	Description
sourceAddress	String	Source address of the transaction
address	String	Destination address of deposit
adminApproval	String	'DONE' , 'REJECTED' , 'AML_DECLINED' or 'FAILED' Status of transaction, see table for more information.
quantity	Number	Size of transaction in specified symbol
subaccount	String	Payment service provider's user who initiates the deposit request
symbol	String	e.g., BTC Crypto symbol
transactionType	String	DEPOSIT | WITHDRAW Type of transaction
txHash	String	Blockchain transaction Hash
txId	String	UUID, unique to the transaction record
txTime	Number	Time of transaction confirmation in blockchain in epoch milliseconds
username	String	Your username
fiatReceived	Number, optional	Amount traded to fiat
currencyTag	String, optional	Additional address property (Tag/Memo) that allows identifying the transfer beneficiary or destination for a transaction