onLoyaltyPointsEarned

Purpose

Triggered when a customer earns loyalty points from a purchase. Use this hook to track customer engagement and loyalty program usage.

When It Triggers

• Customer completes a purchase at a shop with loyalty enabled

• Points are calculated and added to customer's balance

Parameters

Parameter	Type	Description
data.source	number	Server ID of customer
data.shopId	string	Unique shop identifier
data.shopName	string	Display name of the shop
data.shopType	string	Shop type (for unowned shops only)
data.customerIdentifier	string	Customer's identifier
data.customerName	string	Customer's name
data.pointsEarned	number	Points earned from this purchase
data.previousPoints	number	Points before this purchase
data.newPoints	number	Points after this purchase
data.lifetimePoints	number	Total lifetime points earned
data.purchaseAmount	number	Purchase amount that earned points
data.timestamp	number	Server timestamp

Example

exports['sd-shops']:registerServerHook('onLoyaltyPointsEarned', function(data)
    -- Log points earned
    print(('[LOYALTY] %s earned %d points at %s (Total: %d)'):format(
        data.customerName, data.pointsEarned, data.shopName, data.newPoints
    ))

    -- Notify customer
    TriggerClientEvent('ox_lib:notify', data.source, {
        title = 'Loyalty Points',
        description = ('You earned %d points! Total: %d'):format(
            data.pointsEarned, data.newPoints
        ),
        type = 'success'
    })

    -- Track loyalty engagement
    exports['your-analytics']:TrackLoyalty({
        shop = data.shopId,
        customer = data.customerIdentifier,
        pointsEarned = data.pointsEarned,
        purchaseAmount = data.purchaseAmount
    })
end)