reward.redeemed

EVENTRewards

Fires when a redemption is captured, which happens when POST /v1/orders includes its id in redemption_ids. Reserving a reward doesn't fire it, and neither does a hold that expires or is canceled.

data.object is the redemption. One of reward_id (a points reward), wallet_item_id or code is set. previous_attributes holds the old status.

Event JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27{
  "id": "c5a2e8f1-9d3b-4a67-8e0c-4b7f1a3d6e29",
  "type": "reward.redeemed",
  "created_at": "2026-11-05T14:08:52Z",
  "api_version": "v1",
  "livemode": true,
  "brand_id": "e5a1c7d9-2f4b-4c8e-a3d6-8b0f1e9c2a57",
  "data": {
    "object": {
      "id": "4b8d2f6a-9c1e-4a3d-b7f5-0e6c8a2d1b59",
      "status": "captured",
      "member_id": "3f2b8c1e-6d0a-4e7b-9f3c-2a1d5e8b7c40",
      "reward_id": null,
      "wallet_item_id": "7e3a9c51-0b8d-4f2e-a6c4-5d1b9e7f3a28",
      "code": null,
      "discount_cents": 350,
      "points_cost": 0,
      "affected_line_ids": ["3"],
      "order_id": "c9e5a3f1-7d2b-4e8c-a0f6-3b1d9e5c7a24",
      "expires_at": "2026-11-05T14:22:02Z",
      "created_at": "2026-11-05T14:07:02Z"
    },
    "previous_attributes": {
      "status": "reserved"
    }
  }
}