Oxide Banking
Full banking system for FiveM — personal, shared and job accounts, debit cards, loans, credit scores, savings, investments, invoicing, and account security.
oxide-banking is a full banking system for your roleplay server: personal and business accounts, debit cards, transfers, loans, credit scores, savings, investments, invoicing, and account security.
Players use bank branches and ATMs around the map, and every banking screen — accounts, transfers, loans, bills, savings, investments, cards and credit — lives in one interface. Interest, loan instalments, invoice late fees and market moves run on a built-in daily schedule that follows your server's real clock, so the economy keeps moving whether players are online or not.
oxide-banking is framework-agnostic through o-link and runs on QBCore, QBX and ESX. It takes over the qb-banking name, so older scripts built for qb-banking keep working without changes.
Key Features
- Accounts — Every player gets a checking account tied to their framework bank balance, plus shared accounts they can open and invite others to, and a job account for every job your framework defines
- Banks & ATMs — Branches and ATMs across the map, with targeting-eye or walk-up interaction
- Debit Cards — Inventory items with PINs, freezing, replacement, and card-only ATM access
- Account Tiers — Basic, Premium and Business, each with its own upgrade requirements, fees, limits and perks
- Savings & Investments — Savings accounts with a notice period, savings goals, recurring payments, four investment products on a simulated market, certificates of deposit, and dividends
- Loans & Credit — Loans with credit-based rates, automatic instalments, admin approval for large amounts, late fees, collections, and a total borrowing limit
- Credit Scores — Scores that react to how players handle their money, with a full factor breakdown and improvement tips
- Services Screen — Loans, bills, savings, investments, cards and credit each get their own tab, plus an Overview of what needs attention and what is due in the next two weeks
- Security — An optional security PIN for large withdrawals and transfers, ATM PIN lockout, fraud alerts for admins, transaction alerts, and account freezing
- Business Tools — Invoicing (with late fees and automatic collection), expense tracking, income statements, and cash flow reports for job bosses
- Tablet App — When
oxide-tabletis running, the bank also appears as a tablet app with a due-soon badge, tray notifications, and an Upcoming payments widget - Phone App — When
oxide-phoneis running, players can install a Banking app with their accounts, activity, payments, bills, six months of spending insights, cards and loans, plus a balance widget and payment notifications - Vehicle Financing Hooks — Dealership scripts can register and track vehicle loans in the bank
- Legacy Compatibility — Answers to the
qb-bankingresource name and keeps the old exports and callback names working
Requirements
Required
| Resource | Purpose |
|---|---|
ox_lib | Server callbacks, logging, and translations |
oxmysql | Database persistence |
o-link | Connects banking to your framework — players, money, jobs, inventory, targeting, notifications |
| Framework | One of qb-core, qbx_core, or es_extended |
| An inventory | Any inventory o-link supports, such as ox_inventory or qb-inventory. Debit cards are inventory items |
ESX's built-in inventory is not supported
Debit cards are inventory items that carry a card number, and banking places and reads them through o-link. On ESX, use ox_inventory or another inventory o-link supports.
Optional
| Resource | Purpose |
|---|---|
| A target resource | Targeting-eye interaction on banks and ATMs (ox_target, qb-target, or any target o-link supports). Without one, set Config.UseTarget = false to use walk-up prompts |
oxide-tablet | Adds a Banking app to the tablet |
oxide-phone | Adds a Banking app and balance widget to the phone (needs o-link 1.11.0 or newer) |
Supported Frameworks
| Framework | Support |
|---|---|
QBCore (qb-core) | Full |
QBX (qbx_core) | Full |
ESX Legacy (es_extended) | Full |
The framework is detected automatically. There is nothing framework-specific to configure.
Quick Start
Remove or disable your old banking resource (qb-banking, Renewed-Banking, esx_banking, …).
Place oxide-banking in your resources folder and start it after your framework and o-link in server.cfg.
Run sql/install.sql against your database. Updating from an older version? Also run the files in sql/migrations/.
Add the bank_card item to your inventory.
Review the config files under config/.
Start the server and test a bank and an ATM in game.
See the Installation Guide for the full step-by-step setup, including updating from an older version.
What's In The Folder
| Path | Purpose |
|---|---|
config/*.lua | All the settings you can change: banks, tiers, fees, loans, interest |
locales/*.json | Translation files |
sql/install.sql | Database setup script |
sql/migrations/*.sql | Database updates for servers updating from an older version |
itemimages/ | The bank_card item image and a paste-ready ox_inventory_items.lua entry |
server/, client/, web/dist/ | The resource's own code and its pre-built interface. These are locked and do not need editing |
The banking interface ships pre-built in web/dist, so there is nothing to compile or build. Interest, loan payments, invoices, and market updates run on a built-in daily schedule based on your server's real clock (see Scheduling And Time).
Documentation
Installation
Setup, load order, database, the bank card item, and updating.
Configuration
Every config file and setting explained.
Features
Everything the bank can do.
Vehicle Financing
Register dealership vehicle loans in the bank.
Admin Commands
Admin, schedule, and debug commands.
Exports & Integration
Server and client exports, events, and the callback surface.
Localization
Translate the bank with JSON locale files.
Troubleshooting
Common issues and fixes.
Compatibility
Use exports['oxide-banking'] for all new integrations. The resource still provides a legacy qb-banking compatibility surface for older scripts through provides { 'qb-banking' } — see Exports & Integration.