Report offer validation error

Purpose

This webhook is called by Storyous when a previously returned benefit offer cannot be validated and therefore cannot be applied.
It allows the partner to log or react to situations where the POS or Storyous rejected the offer for business or technical reasons.

When it happens

After the partner returns an offer via Get benefit offer, Storyous performs internal validation.

If the offer is invalid (e.g., inconsistent discounts, incorrect totals, missing fields), Storyous notifies the partner by calling this webhook.

The partner should treat this as an error report only; no retry or correction is expected for the same offer.

Request body

loyaltyOfferId — Identifier of the offer that failed validation (the same ID you provided in your Get benefit offer response).

message — A human-readable explanation of why the offer was rejected.

This message may contain technical validation details.

Partners should log this message for debugging and monitoring.

Response

Always respond with 200 OK to confirm receipt.

No retries are performed — Storyous considers the error delivered once a 200 OK is received.

Notes

This webhook is informational. You cannot fix the rejected offer retroactively.

Partners should use the information to adjust their offer-calculation logic and prevent similar issues in future calls.

Make sure to persist loyaltyOfferId in your system so you can match the error notification to the original request/response cycle.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://your-api-server.com' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "loyaltyOfferId": "ab0c2b70fbbfbbe491489caf", "message": "Value to use is not a number", "merchantId": "1", "placeId": "52", "deviceNumber": 76 }'

Request

Responses