loyalty-reward.md

Loyalty Reward

Represents a contract to redeem loyalty points for a reward tier discount. Loyalty rewards can be in an ISSUED, REDEEMED, or DELETED state. For more information, see Manage loyalty rewards.

Structure

LoyaltyReward

Fields

Name	Type	Tags	Description
id	string | undefined	Optional	The Square-assigned ID of the loyalty reward. Constraints: Maximum Length: 36
status	string | undefined	Optional	The status of the loyalty reward.
loyaltyAccountId	string	Required	The Square-assigned ID of the loyalty account to which the reward belongs. Constraints: Minimum Length: 1, Maximum Length: 36
rewardTierId	string	Required	The Square-assigned ID of the reward tier used to create the reward. Constraints: Minimum Length: 1, Maximum Length: 36
points	number | undefined	Optional	The number of loyalty points used for the reward. Constraints: >= 1
orderId	string | undefined	Optional	The Square-assigned ID of the order to which the reward is attached.
createdAt	string | undefined	Optional	The timestamp when the reward was created, in RFC 3339 format.
updatedAt	string | undefined	Optional	The timestamp when the reward was last updated, in RFC 3339 format.
redeemedAt	string | undefined	Optional	The timestamp when the reward was redeemed, in RFC 3339 format.

Example (as JSON)

{
  "status": null,
  "loyalty_account_id": "loyalty_account_id0",
  "reward_tier_id": "reward_tier_id6",
  "order_id": null
}