Skip to main content
PayNext emits webhook events when payments or subscriptions change. Use these event types to update your system in real time—for example, to adjust order status, billing records, or customer access.

Supported Events

Subscribe only to the events your application needs. Each event includes structured data in the webhook payload.

Payment Events

Event nameWhen it firesTypical uses
payment.createdA new payment was createdUpdate order state, start fulfillment
payment.updatedA payment’s status changed (pending, failed, authorized, settling, settled, declined, cancelled, refunded)Sync status, notify customers, adjust inventory
refund.createdA refund process startedTrigger return workflows, update AR
refund.updatedA refund’s status changed (processor-specific statuses)Close tickets, update financial records
Payment events fire immediately when the status changes. Use them to keep PayNext and your order management system synchronized in real time.

Subscription Events

Event nameWhen it firesTypical uses
subscription.createdA subscription was startedProvision access, begin billing
subscription.updatedA subscription was modified (plan, billing cycle)Adjust access, prorated billing
subscription.cancelledA subscription ended or was cancelledRevoke access, close billing cycle
Subscription events cover the full lifecycle—from activation through modifications to cancellation. Use them to manage access and billing automatically. Note that subscription.cancelled also fires when a renewal payment is workflow-blocked—check the associated payment.updated event for decline_code: "workflow_blocked".
Saved payment flows trigger subscription.updated events when plans change with immediate payment or when a past_due subscription recovers.