onLoyaltyRewardClaimed

Purpose

Triggered when a player claims a loyalty reward. Use this hook to play celebration sounds and show reward information.

When It Triggers

• Player redeems points for a reward

• Server confirms the reward was successfully claimed

Parameters

Parameter	Type	Description
data.shopId	string	Unique shop identifier
data.shopName	string	Display name of the shop
data.rewardId	string	Reward identifier
data.rewardName	string	Reward display name
data.rewardType	string	Type of reward ('coupon', 'item', etc.)
data.pointsCost	number	Points spent
data.previousPoints	number	Points before claim
data.remainingPoints	number	Points after claim
data.couponCode	string	Generated coupon code (if applicable)

Example

exports['sd-shops']:registerClientHook('onLoyaltyRewardClaimed', function(data)
    -- Play reward sound
    PlaySoundFrontend(-1, 'MEDAL_UP', 'HUD_MINI_GAME_SOUNDSET', true)

    -- Show reward notification
    lib.notify({
        title = 'Reward Claimed!',
        description = ('%s for %d points'):format(data.rewardName, data.pointsCost),
        type = 'success'
    })

    -- Show coupon code if it's a coupon reward
    if data.rewardType == 'coupon' and data.couponCode then
        lib.notify({
            title = 'Your Coupon Code',
            description = data.couponCode,
            type = 'inform',
            duration = 10000
        })
    end

    -- Log points update
    print(('[LOYALTY] Claimed %s: %d -> %d points'):format(
        data.rewardName, data.previousPoints, data.remainingPoints
    ))
end)