points.redeemed - Mage Loyalty Documentation

{
  "event": "points.redeemed",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "points_redeemed": 500,
    "points_balance": 200,
    "reward_name": "£10 off",
    "reward_id": "clrew456def",
    "discount_code": "MAGE-A1B2C3"
  }
}

{
  "event": "points.redeemed",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "points_redeemed": 500,
    "points_balance": 200,
    "reward_name": "£5.00 off your order",
    "reward_id": "clrew456def",
    "discount_code": "MAGE-A1B2C3",
    "loyalty_mode": "store_credit",
    "currency": "GBP",
    "credit_redeemed": "5.00",
    "credit_balance": "2.00"
  }
}

Fired when a customer successfully redeems points for a reward. At this point the points have been deducted and a discount code has been generated.

Payload fields

Field	Type	Description
`shopify_customer_id`	string	The customer’s Shopify customer ID
`email`	string \| null	The customer’s email address
`points_redeemed`	integer	Number of points spent on this redemption
`points_balance`	integer	The customer’s remaining available points after this redemption
`reward_name`	string	Name of the reward that was redeemed
`reward_id`	string \| null	The reward’s Mage Loyalty ID
`discount_code`	string \| null	The Shopify discount code generated for this redemption

Store-credit shops

On store-credit shops, points_redeemed and points_balance are minor currency units, and data carries loyalty_mode (store_credit), currency, and major-unit decimal-string companions credit_redeemed and credit_balance. Points-mode payloads do not include these fields. See Loyalty modes.

Example payload

{
  "event": "points.redeemed",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "points_redeemed": 500,
    "points_balance": 200,
    "reward_name": "£10 off",
    "reward_id": "clrew456def",
    "discount_code": "MAGE-A1B2C3"
  }
}

{
  "event": "points.redeemed",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "points_redeemed": 500,
    "points_balance": 200,
    "reward_name": "£5.00 off your order",
    "reward_id": "clrew456def",
    "discount_code": "MAGE-A1B2C3",
    "loyalty_mode": "store_credit",
    "currency": "GBP",
    "credit_redeemed": "5.00",
    "credit_balance": "2.00"
  }
}

Common use cases

Send a follow-up email reminding the customer to use their discount code
Log redemptions in an external analytics or BI tool
Trigger a congratulatory push notification
Sync discount code data to a fulfilment or ERP system