wallet.withdrawal.failed - Finogates API Documentation

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

string

Unique identifier of the wallet withdrawal transaction.

string

Final withdrawal status. Always failed for this event.

float

Withdrawal amount expressed in the major currency unit (for example, USD).

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

​Example Payload

​Data Fields

​Handling the Event

Example Payload

Data Fields

Handling the Event