Skip to main content
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

​
payment_id
string
Unique identifier of the wallet withdrawal transaction.
​
status
string
Current withdrawal status. Always initiated for this event.
​
amount
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