Webhook event reference - Zahlo Merchant Developer Docs

Webhook events contain an opaque event ID, event type, creation timestamp, and resource data. The event ID is unique for deduplication; the resource ID is used to retrieve the latest authoritative state.

Payment events

Event	Resource	Merchant action
`payment.created`	Payment	Create or update local pending state
`payment.confirmed`	Payment	Fulfill the matching order once
`payment.failed`	Payment	Keep pending or show recovery
`payment.cancelled`	Payment	Close the unpaid order
`payment.expired`	Payment or session	Release reserved inventory
`refund.succeeded`	Refund	Record the completed refund
`dispute.created`	Dispute	Assign evidence work before the due date

Billing events

Event	Resource	Merchant action
`subscription.created`	Subscription	Start the billing projection
`subscription.updated`	Subscription	Apply plan or status changes
`subscription.cancelled`	Subscription	Apply the stated cancellation policy
`invoice.created`	Invoice	Show or queue the invoice
`invoice.paid`	Invoice	Grant or retain access
`invoice.payment_failed`	Invoice	Start recovery or dunning

Verify the signature, timestamp, and endpoint before using any event. Events can be duplicated, delayed, or delivered out of order; retrieve the resource when order matters.