# Configuration

Coins shop with Tebex top-ups, gifts, loyalty, rotations, owner tools, ESX/QBCore/standalone support, and ready-made web UI.

### Tebex HTTP endpoint

* Path: `POST /varshop/tebex`
* Body: JSON `{ secret, identifier|player, coins|amount|value, reference/transaction }`
* Checks the secret, resolves identifier, credits coins, syncs player if online, returns `{ ok, identifier, balance }`.

### Delivering items (overview)

* Default handlers cover ESX/QBCore for vehicles, weapons, items, money, packs.
* To change behaviour:
  * Configure `Delivery.Handlers` to point a `kind` to your own event/export.
  * Or use Framework hooks (see below) to override `giveVehicle`, `giveWeapon`, `giveItem`, `giveMoney`, `giveVehicle` etc.
* Fallback event (`Delivery.FallbackEvent`) fires when nothing handled the item.

### Exports (server/exports.lua)

* `AddCoins(identifier, amount, context?)`: credit coins.
* `RemoveCoins(identifier, amount, context?)`: remove coins.
* `GetCoins(identifier)`: current balance.
* `GetAccount(identifier)`: ensures and returns account row.
* `RefreshPlayer(playerId)`: re-sync NUI payload for an online player.
* `RegisterSubscriptionPlans(plans)`: register plans (if subscription module present).
* `GetSubscriptionState(identifier)`: current subscription state.

### Framework hooks (server/framework/hooks.lua)

Override core behaviours without touching protected files:

* `resolveIdentifier(source)`: return identifier; `nil` to use default resolution.
* `resolveIdentifierInput(input)`: custom parsing for commands/webhooks.
* `giveVehicle(src, identifier, item)`, `giveWeapon`, `giveItem`, `giveMoney`: return `true/false` if you handled delivery; `nil` to let built-in logic run.
* These hooks run before the rest of the shop logic and are escrow-ignored.

### Usage

* Open shop: `/shop` (or your command), keybind `F4` by default.
* Test drive: available in UI if `TestDrive.Enabled`.
* Add coins: console `varshop:addcoins <identifier|serverId> <amount>` (console/Tebex only).
* Owner tools: allowed identifiers manage promos, stock, rotations, maintenance, spotlight, announcements, theme, webhook directly in UI.