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.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