Skip to main content
The payment.initiated event is sent when a payment has transitioned from an open state into an active attempt. This event indicates that the payment has begun its execution flow but has not yet entered processing or any other state.

​
Example Payload

{
  "event": "payment.initiated",
  "id": "1c5e92e7-4b2b-4a0a-8d7a-8d31f7b52e9a",
  "data": {
    "payment_id": "f4b3d09e-4b27-4c44-9d41-6f7e8a4a2c11",
    "status": "initiated",
    "amount": 599
  },
  "eventGeneratedTime": 1756721043.214908
}

​
Data Fields

​
payment_id
string
Unique identifier for the payment transaction.
​
status
string
Current payment status. Always initiated for this event.
​
amount
float
Payment amount expressed in the major currency unit (for example, USD).

​
Handling the Event

Use this event to:
  • Record the start of a payment attempt
  • Transition the payment into an active state
  • Prevent duplicate initiation of the same payment
  • Monitor payment flow progression