payment.failed - Paywint API Documentation

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

string

Unique identifier for the payment transaction.

string

Final payment status. Always failed for this event.

float

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

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

​Example Payload

​Data Fields

​Handling the Event

​Related Events

Example Payload

Data Fields

Handling the Event

Related Events