wallet.funding.failed - Finogates API Documentation

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

string

Unique identifier of the wallet funding transaction.

string

Final funding status. Always failed for this event.

float

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

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

​Example Payload

​Data Fields

​Handling the Event

Example Payload

Data Fields

Handling the Event