Skip to main content

​
Inbound gift card webhook events

Use this endpoint to push gift card activity events from your system to NowBookIt. NowBookIt processes the event and calls redeem or cancel on the relevant gift card.
This endpoint requires a custom implementation per partner. NowBookIt builds a handler specific to your system’s event format and activity types during onboarding. Contact your NowBookIt partner manager to enable this for your integration.

​
POST GiftCards/partners/{partnerName}/events/{eventType}

Push a gift card activity event to NowBookIt. Path parameters Request body Your system’s native payload — the structure is agreed with NowBookIt during onboarding. NowBookIt’s partner-specific handler transforms your payload into a GiftCardEventPayload and validates it before processing. At minimum the payload must allow NowBookIt to identify:
  • The venue (locationId or equivalent field)
  • The gift card number
  • The activity type (redeem, deactivate, etc.)
  • The amount, if applicable
Processing behaviour NowBookIt validates the request signature via PartnerRequestValidationFilter before any processing occurs. After that:
  1. The partner handler transforms your payload into a GiftCardEventPayload
  2. If the payload is invalid or the activity type is unrecognised, NowBookIt logs a warning and returns 200 — no action is taken
  3. NowBookIt resolves the venue from the locationId in the payload
  4. If gift card integration is not enabled for the venue, NowBookIt returns 200 silently
  5. The event is processed — NowBookIt calls redeem or cancel on the gift card depending on activity type
  6. Always returns 200 OK regardless of outcome
Responses