Cancel Hansel Webhooks

Delivery retry and reliability

Webhook delivery is tracked per event. Failed deliveries can be retried with the retry endpoint, and status metadata helps partners reconcile pending, delivered, failed, and no_endpoints conditions.

POST https://api.cancelhansel.com/v1/webhook-events/{eventId}/retry

Idempotency guidance

Partner systems should handle repeated webhook delivery attempts idempotently, using event identifiers to avoid duplicate processing. This supports safe retry workflows and reliable lifecycle tracking.

Signature verification

Validate the x-cancel-hansel-signature header for all webhook payloads before accepting the event. This helps protect evidence integrity and ensures your systems only process authenticated notifications.

Event types

• booking.created — A new booking entered the protected ledger.
• booking.protected — A booking is now protected with evidence and policy evaluation.
• booking.canceled — A booking cancellation event has been recorded.
• resolution.created — A dispute or resolution evidence packet was generated.

Example payload: booking.created

{
  "eventId": "evt_101",
  "type": "booking.created",
  "bookingId": "booking_789",
  "timestamp": "2026-04-30T12:00:00Z",
  "status": "delivered",
  "payload": {
    "partnerId": "partner_abc",
    "bookingValue": 4500.00,
    "currency": "USD"
  }
}

Example payload: booking.protected

{
  "eventId": "evt_102",
  "type": "booking.protected",
  "bookingId": "booking_789",
  "timestamp": "2026-04-30T12:05:00Z",
  "status": "delivered",
  "payload": {
    "partnerId": "partner_abc",
    "protected": true,
    "evidencePacketUrl": "https://api.cancelhansel.com/v1/bookings/booking_789/evidence"
  }
}

Example payload: resolution.created

{
  "eventId": "evt_103",
  "type": "resolution.created",
  "bookingId": "booking_789",
  "timestamp": "2026-04-30T12:10:00Z",
  "status": "delivered",
  "payload": {
    "partnerId": "partner_abc",
    "resolutionSummary": "Cancellation review created for evidence packet",
    "packetUrl": "https://api.cancelhansel.com/v1/bookings/booking_789/evidence"
  }
}