Webhook Payload

All webhook events share the same structure:

{
  "event": "deposit.confirmed",
  "timestamp": "2024-03-03T08:50:00.000Z",
  "wallet": {
    "id": "wal_abc123",
    "address": "TYVVgZBSUrvntue4WSGWNi15b3er3wiYnh",
    "network": "trc20",
    "crypto": "USDT"
  },
  "deposit": {
    "txHash": "abc123...",
    "amount": "100.50",
    "confirmations": 19
  },
  "sweep": {
    "txHash": "def456..."
  },
  "metadata": {
    "orderId": "ORD-12345",
    "customerId": "cust_abc"
  }
}

Field	Present In	Description
event	All	Event type: deposit.detected, deposit.confirmed, sweep.completed
timestamp	All	ISO 8601 timestamp
wallet	All	Wallet details (id, address, network, crypto)
deposit	All	Deposit info (txHash, amount, confirmations)
sweep	sweep.completed only	Sweep transaction hash
metadata	All (if provided)	Your custom metadata from wallet creation