Itseasy Co Webhooks

generated: '2026-11-12'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.itseasy.co/docs/reference/webhooks
sources:
- https://docs.itseasy.co/docs/reference/webhooks
- https://docs.itseasy.co/docs/reference/api/account-and-operations
description: Easy Labs delivers asynchronous notifications about account activity via HTTPS POSTs to a registered endpoint.
events:
- event: payment.created
  description: a new payment is initiated
- event: payment.updated
  description: payment status changed (succeeded, failed, refunded, etc.)
- event: refund.created
  description: a refund is initiated
- event: refund.updated
  description: refund status changed
- event: authorization.created
  description: an authorization is created (manual capture flow)
- event: authorization.updated
  description: 'authorization status changed; a void arrives as an .updated carrying is_void: true and a void_status'
- event: checkout.session.completed
  description: a hosted/embedded Checkout session closes successfully
- event: checkout.session.crypto_confirmed
  description: a crypto checkout confirms on-chain
- event: subscription.created
  description: a new subscription is created
- event: subscription.updated
  description: subscription fields change (plan, quantity, billing cycle, etc.)
- event: subscription.deleted
  description: subscription canceled
- event: subscription.paused
  description: subscription paused (collection paused or fully halted)
- event: subscription.resumed
  description: subscription resumed
- event: subscription.trial_will_end
  description: fires 3 days before a trial ends
- event: subscription.pending_update_applied
  description: a scheduled update took effect
- event: subscription.price_change.scheduled
  description: a price change is scheduled
- event: subscription.price_change.canceled
  description: a scheduled price change is canceled
- event: subscription.price_change.applied
  description: a scheduled price change takes effect
- event: invoice.created
  description: a draft invoice is created
- event: invoice.finalized
  description: invoice is finalized and ready to send/charge
- event: invoice.paid
  description: invoice fully paid
- event: invoice.payment_failed
  description: payment attempt failed (triggers dunning)
- event: invoice.upcoming
  description: fires before the next renewal so you can preview the invoice
- event: invoice.voided
  description: invoice voided
- event: invoice.marked_uncollectible
  description: invoice flagged unrecoverable
- event: coupon.created
- event: coupon.updated
- event: coupon.deleted
- event: promotion_code.created
- event: promotion_code.updated
- event: promotion_code.deleted
- event: revenue_recovery.action_completed
delivery:
  signature: x-easy-webhook-signature header containing t=<unix>,sha256=<hex> (may include multiple sha256 entries during secret rotation)
  content_type: application/json
note: Verify the signature using EasyWebhooks.constructEvent with the raw request body and the secret obtained at registration. The secret is
  never re‑exposed after registration. The event type is also provided in the x-easy-event header and in the payload's "type" field. The delivery
  includes x-easy-delivery-id for idempotency and x-easy-webhook-attempt indicating the retry attempt number. Responses must be 2xx within 5 seconds;
  otherwise a retry is triggered.
docs: https://docs.itseasy.co/docs/reference/webhooks