Payout Webhook

We offer webhook callbacks for clients that want to be updated when a deposit is detected on-chain or finalized.

Webhook payload examples

Aquanow invoice guarantees at-least-once delivery of our webhook messages, and to avoid duplicates, you can utilize txHash and adminApproval as deduplication IDs.

Invoice Closed / Fully Paid

{
 "txId": "2df3f8d5-c7aa-4767-b556-d253cdba1cde",
 "accountId": "CA1001112C",
 "address": "0x279FEC0A6Dd30be27D88E837a1f8cC59bD2Bfc07",
 "adminApproval": "DONE",
 "createdAt": 1740417641597,
 "updatedAt": 1740461310234,
 "deliverCurrency": "USD",
 "deliverQuantity": 100,
 "networkFee": 0,
 "networkType": "ETH",
 "orderId": "f9ff8029-ce8d-4469-8116-f3b12f1f87d8",
 "receiveCurrency": "USDT",
 "receiveQuantity": 99.897106,
 "symbol": "USDT",
 "tag": "clientid231",
 "referenceId": "abcd",
 "txHash": "0xc67e3f632a23fb2b8ab025bd6b92539409032b8f7723f4f5dfd540fc1f5f06be",
 "updatedAt": 1740418042025,
 "username": "woojpay"
}
  

Callback parameter values

Parameter	Type	Description
txId	string	transaction Id provided by Aquanow, can be used for query an transaction status
username	string	Your username
accountId	string	accountId for your Aquanow account
createdAt	number	Time of invoice creation in epoch
adminApproval	"REJECTED" | "CANCELLED" | "DONE"	Status of the payout.
address	string	Address Withdrawn To (IF Crypto)
deliverCurrency	string	Currency type delivered by user to be traded.
deliverQuantity	string	Quantity of currency delivered by user.
receiveCurrency	number	Currency type withdrawn by user
receiveQuantity	number	Quantity of currency withdrawn.
networkFee	number	Fee of the Withdraw (in receiveCurrency)
networkType	string	Specify a networkType for symbols that support multiple networks.
referenceId	string	Id of document being used for reference.
expirationTime	number	Time of expiration in epoch
txHash	string	Blockchain transaction Id