onCustomerPurchase

Purpose

Triggered when a customer successfully purchases items from a shop. Use this hook to log purchases, integrate with MDT systems, track economy, or send Discord webhooks.

When It Triggers

• Customer completes checkout

• Payment is processed successfully

• Items are added to customer's inventory

Parameters

Parameter	Type	Description
data.source	number	Player server ID who made the purchase
data.shopId	string	Unique shop identifier
data.shopType	string	Type of shop (e.g., '247store', 'liquorstore')
data.shopName	string	Display name of the shop
data.isShopOwned	boolean	Whether the shop has a player owner
data.ownerIdentifier	string	Shop owner's identifier (if owned)
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 (after discounts)
data.items[i].originalPrice	number	Original price per unit
data.items[i].category	string	Item category
data.items[i].metadata	table	Item metadata (if any)
data.totalAmount	number	Final total after all discounts
data.subtotal	number	Original total before discounts
data.paymentMethod	string	'cash', 'bank', 'society', or 'black_money'
data.societyName	string	Society name if using society payment
data.customerIdentifier	string	Customer's player identifier
data.customerName	string	Customer's character name
data.discounts	table	Breakdown of discounts applied
data.discounts.sales	number	Discount from active sales
data.discounts.coupon	number	Discount from coupon
data.discounts.loyalty	number	Discount from loyalty points
data.couponCode	string	Coupon code used (nil if none)
data.couponDiscount	number	Coupon discount percentage
data.saleId	string	Active sale ID (nil if none)
data.saleName	string	Active sale name
data.saleDiscount	number	Sale discount percentage
data.loyaltyPointsEarned	number	Points earned from this purchase
data.loyaltyPointsUsed	number	Points redeemed in this purchase
data.newLoyaltyBalance	number	Customer's new loyalty points balance
data.taxAmount	number	Tax amount applied
data.taxRate	number	Tax rate percentage
data.timestamp	number	Server timestamp (os.time())

Example

exports['sd-shops']:registerServerHook('onCustomerPurchase', function(data)
    -- Log purchase to console
    print(('[PURCHASE] %s bought %d items for $%d at %s'):format(
        data.customerName, #data.items, data.totalAmount, data.shopName
    ))

    -- Build item list for logging
    local itemList = {}
    for _, item in ipairs(data.items) do
        table.insert(itemList, ('- %s x%d ($%d)'):format(
            item.label, item.quantity, item.price * item.quantity
        ))
    end

    -- Send to Discord logging
    exports['your-logging']:Log('shop-purchase', {
        player = data.customerName,
        identifier = data.customerIdentifier,
        shop = data.shopName,
        total = data.totalAmount,
        items = table.concat(itemList, '\n'),
        paymentMethod = data.paymentMethod
    })

    -- Register weapons to MDT
    for _, item in ipairs(data.items) do
        if item.item:find('WEAPON_') then
            local serial = item.metadata and item.metadata.serial
            exports['your-mdt']:RegisterWeapon(data.customerIdentifier, item.item, serial)
        end
    end
end)