Skip to main content
The payment.failed event is sent when a payment attempt fails and the transaction reaches a final, non-recoverable state. After this event is emitted, the payment will not continue processing.

​
Example Payload

{
  "event": "payment.failed",
  "id": "77b568f8-cc38-4b5c-91aa-ac3c77020963",
  "data": {
    "payment_id": "ac4bedda-f370-4ac4-a61e-e1761a5a51b9",
    "status": "failed",
    "amount": 599,
    "failed_reason": "Transaction could not be processed. Try again later."
  },
  "eventGeneratedTime": 1756452659.868249
}

​
Data Fields

​
payment_id
string
Unique identifier for the payment transaction.
​
status
string
Final payment status. Always failed for this event.
​
amount
float
Payment amount expressed in the major currency unit (for example, USD).
​
failed_reason
string
Human-readable explanation describing why the payment failed.

​
Handling the Event

Use this event to:
  • Update the payment record to a failed state
  • Synchronize failure status across systems
  • Record failure details for auditing or analysis
  • Determine next steps based on your application logic