wallet.withdrawal.initiated - Finogates API Documentation

The wallet.withdrawal.initiated event is sent when a wallet withdrawal request has been successfully initiated. This indicates that the withdrawal process has started but has not yet entered processing or settlement.

Example Payload

{
  "event": "wallet.withdrawal.initiated",
  "id": "6d6a74ab-89ae-4b2e-bcd1-a04307d7df99",
  "data": {
    "payment_id": "6d6a74ab-89ae-4b2e-bcd1-a04307d7df99",
    "status": "initiated",
    "amount": 500.0
  },
  "eventGeneratedTime": 1756729948.128641
}

Data Fields

string

Unique identifier of the wallet withdrawal transaction.

string

Current withdrawal status. Always initiated for this event.

float

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

Handling the Event

Use this event to:

Record the initiation of a wallet withdrawal
Transition the withdrawal into an active state
Prevent duplicate withdrawal attempts
Monitor withdrawal flow progression

​Example Payload

​Data Fields

​Handling the Event

Example Payload

Data Fields

Handling the Event