Skip to main content
The wallet.withdrawal.rejected event is sent when a wallet withdrawal request is rejected before completion. This typically occurs due to compliance checks, risk controls, insufficient permissions, or policy restrictions.

​
Example Payload

{
  "event": "wallet.withdrawal.rejected",
  "id": "c4e71799-fd67-4995-b06e-447c2588660a",
  "data": {
    "payment_id": "c4e71799-fd67-4995-b06e-447c2588660a",
    "status": "rejected",
    "amount": 200.0
  },
  "eventGeneratedTime": 1756729948.128641
}

​
Data Fields

​
payment_id
string
Unique identifier of the wallet withdrawal transaction.
​
status
string
Final withdrawal status. Always rejected for this event.
​
amount
float
Withdrawal amount expressed in the major currency unit (for example, USD).

​
Handling the Event

Use this event to:
  • Mark the withdrawal transaction as rejected
  • Notify the user of the rejection outcome
  • Prevent automatic retries
  • Record rejection details for compliance and auditing