Account Funding: deposit expiration webhook
August 12th, 2025
Release date
Aug 13th, 2025
Release Type:
Informational, no action required from platforms
Summary
Applicable to the Account Funding product, ZeroHash has added a new webhook event to notify your platform when an End Customer’s fund transaction does not complete successfully - that is, when no deposit or fiat conversion has occurred. This event serves as a clear signal that no balance updates or account changes should be made, helping prevent discrepancies and ensuring accurate account state management.
The webhook will fire 30 minutes after the JWT token is generated and no fund activity is detected.
Example payload (see reason field):
{
"participant_code": "XXC653",
"fund_asset": "ETH",
"quoted_currency": "USD",
"source_address": "-",
"deposit_address": "0x30E76aDa6a159D742a33Ec1aF6Bd58FeB666145E",
"quantity": "0",
"notional": "0",
"fund_id": "143121c8-5f32-48bc-8277-5212d47a07ed",
"transaction_id": "",
"account_label": "general",
"success": false,
"reason": "deposit session has expired.",
"reference_id": "e460e9c3-973b-48a1-9f3b-51840a283f09",
"raw_fee_bps": "0",
"deposit_fee_bps": "0",
"raw_fee_notional": "0.00",
"deposit_fee_notional": "0.00"
}