
🎥 DEMO VIDEO
👉 Click here to watch the video
📝 FULL DOCUMENTATION
👉Click here to view the documentation
💰 JK Billing
The complete standalone invoicing system for your FiveM server
JK Billing is a powerful and fully standalone billing resource that lets players send, receive, pay, and manage invoices through an elegant NUI interface — with support for society accounts, personal invoices, a product catalog, and in-world tablets.
📦 What's Included
This package contains the FiveM Lua script required to:
↪ Manage invoices (society & personal) with a modern NUI interface
↪ Create product catalogs per job with categories, prices, and images
↪ Place interactive tablet props in the world to display your catalog
↪ Log invoices to Discord via webhooks
↪ Optionally sync with the ActivityManager Discord Bot
⭐ Main Features
🧾 Society Invoices
↪ Send invoices on behalf of your job — payments go to the society bank account
↪ Grade-based visibility: only top-grade employees see the society tab
↪ High-grade employees can pay invoices using society funds
↪ Configurable job whitelist/blacklist system
👤 Personal Invoices
↪ Peer-to-peer invoicing between any players
↪ Payment goes directly to the issuer's bank account
↪ Independent from job permissions — any player can send one
🛒 Product Catalog System
↪ Create categories and products per job with name, price, and image
↪ Auto-fetch item images from your inventory system (8+ supported)
↪ Take in-game screenshots and attach them to products via Discord webhook
↪ Custom image URLs supported (Imgur, Discord CDN, etc.)
↪ Enable/disable individual products and control sort order
📱 In-World Catalog Tablets
↪ Place physical tablet props anywhere in the world (`/jkplacetablet`)
↪ Customers interact with tablets to browse your job's product catalog
↪ Full placement controls: rotation, height adjustment, raycast preview
↪ Remove tablets with `/jkremovetablet`
🏦 Integrated Banking System
Natively compatible with 6+ banking/society account systems:
↪ esx_addonaccount / esx_society
↪ qb-management / qbx_management
↪ qb-banking
↪ okokBanking
↪ snipe-banking
↪ tgg-banking
➕ Fully extensible — implement your own via sv_banking_public.lua (not encrypted).
📸 In-Game Screenshot System
↪ Take screenshots directly from the billing UI
↪ Automatically uploaded via Discord webhook
↪ Requires `screencapture` or `screenshot-basic`
📢 Discord Webhook Logs
↪ Separate webhooks for invoice created & invoice paid events
↪ Rich embeds with invoice details, amounts, issuer, and payer info
🔗 ActivityManager Integration
↪ Automatic invoice sync with the ActivityManager Discord Bot
↪ Only for jobs linked to a Discord guild
↪ Two-way communication: ActivityManager can also create invoices in JK Billing
🔧 Framework Compatibility
| Framework | Support |
| ESX Legacy | ✅ Full |
| QBCore | ✅ Full |
| QBox (qbx_core) | ✅ Full |
| Standalone | ⚠️ Basic
🗄️ Supported Databases
↪ oxmysql
↪ mysql-async
↪ ghmattimysql
🌐 Available Languages
↪ 🇮🇹 Italiano
↪ 🇬🇧 English
🔓 **Open Files (Escrow Ignored)**
↪ config.lua — Full configuration
↪ sv_framework_public.lua — Framework layer (customizable)
↪ sv_banking_public.lua — Banking layer (customizable)
↪ en.lua & it.lua — Translations
↪ `html/*` — Full NUI (index.html, style.css, app.js, catalog.js)
📋 **Requirements**
↪ FiveM Server (build 5181+)
↪ MySQL database (oxmysql, mysql-async, or ghmattimysql)
↪ A supported framework or Standalone mode
↪ A supported banking resource (or custom implementation)
🎁 **What's NOT Included**
↪ ❌ ActivityManager Discord Bot
(Available for free at activitymanager.it — optional integration)
↪ ❌ Premium Access for ActivityManager
(JK Billing works 100% standalone without ActivityManager)
✅ **Why Choose JK Billing**
✔ Fully standalone — no external dependencies beyond your framework
✔ Society + Personal invoices in a single resource
✔ Beautiful NUI with real-time data
✔ Product catalog with in-world tablets for immersive RP
✔ Open public files — customize framework and banking without limits
✔ Auto-detects everything: framework, banking, database, inventory images
✔ Discord logging and ActivityManager sync out of the box
