JK Billing

🎥 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