This event is triggered every time a customer’s point balance changes. The event will provide a customer’s previous point balance, current point balance, and how many points it changed by.
This event is useful for keeping an external system that stores a customer’s point balance in sync.
Please note:
The reason for the change in balance is included in the event and can be one of the following:
- Campaign Earned - based on campaign title
- Points Expired
- Manual adjustment of points - based on description
- Refund made
- Import
- Redemption Made
| Important Attributes | Description |
|---|---|
email | The email address of the customer whose point balance changed. |
previous_balance | The customer’s point balance before the change. |
current_balance | The customer’s point balance after the change. |
difference | How many points were added or removed from the customer’s point balance. |
added_or_removed | Delineates whether points were added or removed from the customer’s point balance. |
points_changed_reason | Describes why there was a change in point balance. |
{
"topic": "swell/points/changed",
"name": "Swell Points Changed",
"email": "[email protected]",
"customer": {
"total_spend_cents": 3180,
"total_purchases": 4,
"perks_redeemed": 58,
"last_purchase_at": "2019-11-28T12:50:52.000Z",
"email": "[email protected]",
"referred_by": "[email protected]",
"points_earned": 2460,
"points_balance": 460,
"points_expire_at": null,
"first_name": "a",
"last_name": "a",
"is_member": true,
"accepts_marketing": false,
"last_seen_at": "2019-12-09T16:41:26.214Z",
"thirty_party_id": "2691804725305",
"referral_link": "http://rwrd.io/3120htx",
"referral_discount_code": null,
"has_store_account": true,
"credit_balance": "₪0",
"is_affiliate": false,
"vip_tier_name": "Power User",
"vip_tier_ends_at": "2019-12-31",
"referral_code": {
"code": "3120htx",
"shares": 1,
"facebook_shares": 1,
"twitter_shares": 0,
"email_shares": 0,
"emails_sent": 0,
"emails_viewed": 0,
"links_clicked_from_email": 0,
"links_clicked_from_twitter": 0,
"links_clicked_from_facebook": 0,
"orders": 0,
"amount_cents": 0,
"average_amount_cents": 0,
"expires_at": null,
"expired": false,
"completed_referral_customers": [],
"email": "[email protected]",
"unique_clicks": 0,
"total_clicks": 0
}
},
"previous_balance": 960,
"current_balance": 460,
"difference": -500,
"added_or_removed": "removed",
"points_changed_reason": "Get ₪5.00 off your next purchase for 500 points",
"timestamp": "2021-08-01T16:53:56.415+03:00"
}
Please note:
When a customer has their points balance changed due to redemption, the points_changed_reason will populate with the redemption option description value.
If the description is empty, the points_changed_reason will show 'unknown