Troubleshooting

Most problems show themselves in the server console or the F8 client console — filter for [nexdev_donatorsystem] first.

Tebex / redemption

Problem	Fix
`Tebex API returned status 404`	The order ID couldn’t be found by Tebex. Double-check it’s the full `tbx-xxxxxx-xxxxxx` string, that `sv_tebexSecret` matches the store the player bought from, and that the order has finished processing (give it a minute after checkout).
`Tebex secret not configured (sv_tebexSecret convar)`	You haven’t set the secret. Add `sv_tebexSecret "..."` to your `server.cfg` above `ensure nexdev_donatorsystem` and restart. See Tebex setup.
`This order has been refunded or charged back`	Working as intended — the buyer reversed payment. They keep nothing.
`This order has already been redeemed`	Each Tebex order can only be redeemed once. If a player insists they didn’t, check the `nexdev_donatorsystem_redeems` table — the redeemer’s identifier is recorded.
Order redeems for 0 currency	The package ID isn’t in `ServerConfig.CoinPackages` and `ServerConfig.CoinPerDollar` is `0`. Either add the package to the map, or set a fallback rate. See Tebex setup → Step 3.

Admin access

Problem	Fix
Admin tab missing from the sidebar	Your `license:` isn’t in `Config.Admins`. Look it up via `tx admin lookup <name>` or `getplayerlist`.
`/givecoins` / `/setcoins` say “No permission” in chat	Same fix — license not in `Config.Admins`. Console runs are always allowed.

Delivery

Problem	Fix
`Failed to register vehicle`	The insert into `player_vehicles` failed. Make sure your framework’s `player_vehicles` table exists and matches the standard schema.
Items don’t land in inventory	`ox_inventory` isn’t started, or you’ve forced `Config.Inventory` to a script that isn’t running. Set `Config.Inventory = 'auto'` and let the script pick. Check F8 for the active inventory bridge on resource start.
Vehicle spawns but I have no keys	Either no keys script is detected, or you’ve set `Config.GiveVehicleKeys = false`. List of supported keys scripts is in Configuration → Vehicle keys.
Item card has no image	The admin didn’t set an image URL and the auto-built path doesn’t resolve. Set `Config.ItemImagePath` to your inventory’s image folder (`nui://qb-inventory/html/images/`, `nui://ps-inventory/html/images/`, etc.), or set explicit URLs on each package.

UI / general

Problem	Fix
`Slow down. Try again in a few seconds.`	Anti-spam protection. Wait and retry.
Theme changes don’t stick	They’re saved per-server in the `nexdev_donatorsystem_settings` table. If they revert on restart, check the server console for SQL errors.
Customize UI changes one client doesn’t see	Other clients pick up the new theme on next shop open. Have them close and re-open the shop.

Database

The schema is idempotent and re-verifies on every boot. You should see this in the console at start-up:

[nexdev_donatorsystem][schema] 7/7 tables verified, 4 default categories seeded.
[nexdev_donatorsystem] Loaded N items, N categories, N deals.

If you see fewer than 7/7 tables verified, your MySQL user is missing CREATE permission on the database — grant it and restart. The seven tables are:

nexdev_donatorsystem
nexdev_donatorsystem_items
nexdev_donatorsystem_categories
nexdev_donatorsystem_purchases
nexdev_donatorsystem_deals
nexdev_donatorsystem_codes
nexdev_donatorsystem_redeems
nexdev_donatorsystem_settings

Before opening a support ticket

Please include:

Server console output filtered for [nexdev_donatorsystem].
F8 client console output filtered for [nexdev_donatorsystem].
Your framework (Qbox / QBCore / ESX), inventory, and keys script.
The order ID (for Tebex issues) — never share your sv_tebexSecret.
What you did and what you expected to happen.

See Support & contact.

Get Started

Scripts

Changelog

Troubleshooting

Tebex / redemption

Admin access

Delivery

UI / general

Database

Before opening a support ticket

​Tebex / redemption

​Admin access

​Delivery

​UI / general

​Database

​Before opening a support ticket

Tebex / redemption

Admin access

Delivery

UI / general

Database

Before opening a support ticket