RewardUpdate

Description: Triggered when an existing reward is updated.

When to use: Subscribe to this event if you need to update your records when reward data changes.

Sources:

• iOS and Android Mobile SDK reward events are triggered.

Payload Structure:

{
  "id": "UUID for webhook message",
  "timestamp": 1778077677000,
  "payload_data": {
    "blink_receipt_id": "UUID - Primary Blink Receipt ID",
    "client_user_id": "The client-specific user identifier",
    "update_type": "[reward|missed_earnings]",
    "status": "[pending|complete]",
    "reward_id": "uuid",
    "reward_type": "[promo|boost|barcode_collection|base_scan]",
    "reward_amount": 1.00,
    "promo_ids_updated": [123],
    "qualified_promos": [
      {
        "promo_id": 123,
        "title": "Name of the promotion the user's receipt qualified for",
        "qualified_count": 1,
        "promo_amount": 1.00,
        "status": "[pending|accepted|rejected]",
        "reason": "Reason for status=pending or state=rejected",
        "products": [
          {
            "description": "Product description of the specific qualified promo",
            "price": 1.00,
            "quantity": "Quantity of the product(s) associated with the specific qualified promo"
          }
        ]
      }
    ]
  },
  "payload_type": "RewardUpdate",
  "version": 1
}

For promo and missed earnings updates, qualified_promos contains the current full state for all qualifying promos, while promo_ids_updated contains the promo IDs whose status is first reported or changed in that specific webhook message.