wasabi_billing
wasabi_billing is a billing and invoice-management resource for FiveM with personal and society invoices, a React/NUI dashboard, VAT, employee commissions, physical invoice copies, and administration tools.
The resource folder must be named wasabi_billing. Keep this name in your server.cfg, exports, and inventory item definitions.
Features
- Personal invoices — Issue invoices to nearby players and browse received and sent invoices with status filters and invoice details.
- Society invoices — Issue invoices as your job, bill configured societies, and manage society invoices with separate sending and management grade requirements.
- Dashboard — Overview statistics, recent activity, personal and society views, a detail rail, reference copying, and payment/cancellation confirmations.
- Keymapping — Configurable hotkey (default F7) to open the billing menu, with full keybind customization in config and FiveM settings.
- Invoice presets — Job-filtered categories populate reasons and amounts; custom reasons and amounts remain available.
- Pay by reference — Look up an invoice before payment. A player can pay another character's invoice from their own cash or bank account.
- VAT and revenue sharing — Add tax to new invoices, optionally route it to a dedicated society, and pay a configured share of society invoice revenue to the issuing employee.
- Physical invoice item — Online personal recipients can receive a metadata-bearing invoice item which opens a paper-style receipt.
- Overdue collection — Flag expired invoices or enable automatic bank collection, including offline characters through the framework bridge.
- Admin tools — Search invoices, look up citizens by name or identifier, browse societies, cancel eligible invoices, delete individual records, and clear records for an identifier.
- Editable integrations — Framework, banking, inventory, notification, and logger bridges; configurable UI colors and JSON locales.
- Database setup and import — Automatic table setup, existing invoice-table upgrades, and opt-in imports from supported billing systems.
- Developer interfaces — Client UI exports, server invoice exports, a UI-state event, and selected compatibility interfaces.
See Using Billing for workflows and current limitations, and Migration before replacing an existing installation.
Frameworks and money handling
Built-in server bridges detect ESX (es_extended), QBCore (qb-core), or QBOX (qbx_core). A custom framework template is included, but must be implemented before use.
Personal money is handled by the framework; a separate banking resource is not required for personal invoicing. Society invoices need a supported society-account backend. Optional adapters support wasabi_banking, qb-banking, okokBanking, Renewed-Banking, and ESX shared accounts. “Standalone billing” does not mean framework-free money or identity handling.
See Dependencies for exact integration requirements.
Configuration and editable files
| File or directory | Purpose |
|---|---|
config/shared/config.lua | Currency, invoice rules, VAT, item name, distance, society permissions, and presets |
config/client/config.lua | Commands, keybind, notification provider, and UI colors |
config/server/config.lua | Database setup, admin ACE, providers, overdue interval, logging, storage overrides, and compatibility/import switches |
bridge/ | Framework, banking, inventory, notification, logger, and compatibility adapters |
locales/*.json | Notification, command, and UI translations |
_INSTALL_FIRST/README.md | Inventory item installation examples |
types.lua | Lua type definitions for developers |
The manifest excludes bridges, configuration, and types.lua from escrow. Locale JSON files are shipped as editable resource files. There is no separate wasabi_bridge dependency.
Getting started
- Check Dependencies.
- Follow Installation, including the optional invoice item.
- Review Configuration before enabling collection or society payments.
- Use Exports and Events for integrations.