Skip to main content
The wallet.funding.failed event is sent when a wallet funding request fails and reaches a final, non-recoverable state. After this event is emitted, the funding attempt will not continue processing.

​
Example Payload

{
  "event": "wallet.funding.failed",
  "id": "757a92ca-1138-4a45-8f15-03dd4529230a",
  "data": {
    "payment_id": "757a92ca-1138-4a45-8f15-03dd4529230a",
    "status": "failed",
    "amount": 100.0,
    "failed_reason": "Insufficient balance"
  },
  "eventGeneratedTime": 1756729948.128641
}

​
Data Fields

​
payment_id
string
Unique identifier of the wallet funding transaction.
​
status
string
Final funding status. Always failed for this event.
​
amount
float
Funding amount expressed in the major currency unit (for example, USD).
​
failed_reason
string
Human-readable explanation describing why the wallet funding failed.

​
Handling the Event

Use this event to:
  • Mark the funding transaction as failed
  • Display the failure reason to the user
  • Prevent retries without user intervention, if applicable
  • Log failure details for auditing and analysis