onPurchaseCompleted

Purpose

Triggered when a purchase is successfully completed after server confirmation. Use this hook to play sounds, show receipts, or celebrate loyalty points earned.

When It Triggers

• Server confirms the purchase was successful

• Items have been added to player inventory

• Money has been deducted

Parameters

Parameter	Type	Description
data.shopId	string	Unique shop identifier
data.shopName	string	Display name of the shop
data.items	table	Array of purchased items
data.items[i].item	string	Item spawn name
data.items[i].label	string	Item display name
data.items[i].quantity	number	Quantity purchased
data.items[i].price	number	Price per unit
data.totalAmount	number	Final total paid
data.paymentMethod	string	Payment method used
data.discountApplied	number	Total discount amount
data.loyaltyPointsEarned	number	Points earned from purchase
data.newLoyaltyBalance	number	Updated loyalty points balance

Example

exports['sd-shops']:registerClientHook('onPurchaseCompleted', function(data)
    -- Hide loading indicator
    lib.hideTextUI()

    -- Play purchase success sound
    PlaySoundFrontend(-1, 'PURCHASE', 'HUD_LIQUOR_STORE_SOUNDSET', true)

    -- Show receipt notification
    lib.notify({
        title = 'Purchase Complete',
        description = ('Paid $%d at %s'):format(data.totalAmount, data.shopName),
        type = 'success'
    })

    -- Show loyalty points if earned
    if data.loyaltyPointsEarned and data.loyaltyPointsEarned > 0 then
        lib.notify({
            title = 'Loyalty Points',
            description = ('+%d points (Total: %d)'):format(
                data.loyaltyPointsEarned, data.newLoyaltyBalance
            ),
            type = 'inform'
        })
    end

    -- Show discount if applied
    if data.discountApplied and data.discountApplied > 0 then
        print(('[PURCHASE] Saved $%d with discounts'):format(data.discountApplied))
    end
end)