Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.finogates.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Example Payload

{
  "event": "wallet.withdrawal.failed",
  "id": "d0d77ff7-7952-4612-86f5-af5982432626",
  "data": {
    "payment_id": "d0d77ff7-7952-4612-86f5-af5982432626",
    "status": "failed",
    "amount": 690.0,
    "failed_reason": "Transfer could not be completed"
  },
  "eventGeneratedTime": 1756729948.128641
}

​
Data Fields

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

​
Handling the Event

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