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


Data Fields

string
Unique identifier for the payment transaction.
string
Current payment status. Always initiated for this event.
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