Skip to main content
For general webhook concepts like bubble-up behavior, payload visibility rules, and versioned snapshots, see Webhook Concepts.

Description

This event is triggered when a new payment transaction is initiated.

Integration Details

  • Subscription Key: pay.transaction.created
  • Use Case: Track revenue in real-time or update an external financial ledger.
  • Related Events: pay.transaction.updated

Trigger

  • Event Type: pay_transaction_created
  • Source: Insertion of a record into the pay.transaction table.

Cross-Service References

The payment payload traverses the order chain to provide full purchase context:
  • Order (pay.order): Order metadata and status.
  • Order ItemsItemSKU (pay.sku): Product details including pricing and currency.
  • Coupon (pay.coupon): Discount information if applied.

Payload Example

Payload Type Showcase

Field Notes

  • payment_id is a UUID from the payment gateway (e.g., Stripe, Razorpay).
  • narration is a human-readable payment description.
  • transaction_status_history provides the status audit trail. Empty on creation, populated on subsequent status transitions.
  • coupon on order items is nullable — only present if a discount was applied.
  • The order → order_items → item → sku chain provides the full purchase context.