Search
K

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