> For the complete documentation index, see [llms.txt](https://ambr4-scripts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ambr4-scripts.gitbook.io/docs/scripts/banking-system.md).

# Banking System

`ambr4_banking` is a complete financial ecosystem for FiveM RP servers. It combines daily banking, ATM usage, subscriptions, invoices, lending, crypto, and analytics into one connected system with a consistent premium UI and a framework-ready backend.

### Purchase the Script

{% embed url="<https://ambr4scripts.com/products/banking-system>" %}

### Showcase

{% embed url="<https://youtu.be/P5kSmIwu6gY>" %}

### Features

#### 🧩 Full Banking UI Suite

* Complete multi-page interface: **Dashboard, Analytics, My Payments, My Trades, Loans, My Loans, My Updates, Account, Settings, Support**.
* Unified visual design across cards, modals, badges, tables, toggles, dropdowns, and notifications.
* Fast page switching with immediate UI refresh after key actions (payments, loans, billing updates, card actions).

#### 🗂️ Accounts and Access Model

* Multi-account support with account types: **Main, Savings, Business, Joint, Shared, Social (society)**.
* Active account system for transaction context (operations follow currently selected account).
* Account creation and removal with confirmation flow.
* Shared account member management with granular permissions: `view`, `deposit`, `withdraw`, `transfer`.
* Shared defaults in Settings to predefine permissions for newly added members.
* Social/society accounts mapped by job + boss grade via config for role-restricted access.

#### 💸 Core Transactions

* Deposit, withdraw, and transfer flows with server-side validation.
* IBAN resolution/recipient lookup before transfer confirmation.
* Transfer defaults system (quick amount chips + default note mapping).
* Real-time activity updates for core money actions.

#### 🧾 Billing and Invoices

* **Billing History** with statuses, period filters, search, and invoice detail modal.
* Invoice payment directly from bank UI (supported provider flow).
* Connected plan billing + external invoice history in one clean banking view.
* Provider bridge architecture:
  * Native provider support: `esx_billing`, `qb_phone`
  * Custom billing scripts through `AddBillingEntry` export.

#### 📈 Plans, Limits, and Renewals

* Built-in subscription system with **Basic / Plus / Elite** plans.
* Per-plan limit enforcement for transfers, withdraws, bank loan max, P2P publish, and crypto allowance.
* Periodic renewal sweep with automatic handling of successful renewals and failed charges.
* Auto-renew toggle in Settings (Plan & Billing section), with stored next/last charge data.
* Downgrade safety behavior when paid renewals fail.

#### 🏧 Card and ATM Security

* Dedicated ATM module (separate UI from main bank panel) with configurable ATM model list.
* ATM interaction modes: text interaction or target interaction.
* Account selection flow for ATM operations, including availability checks.
* Optional ATM PIN gate based on user settings.
* Configurable failed PIN attempt lock (`PinMaxAttempts`) with card status sync.
* Card unlock flow (optional fee, optional owner-only restriction) and new PIN setup.
* Card settings support: PIN update, design/signature controls, status handling.

#### 🎨 Card Personalization

* Multiple bank card designs with instant preview in UI.
* Custom card signature input saved per account.
* Card details panel with status-aware behavior (`Active` / `Blocked`).
* PIN-protected card flow prepared for ATM and card-security actions.

#### 🏦 Loans and Credit System

* Dual loan ecosystem:
  * **Bank Loans** (configured offers, terms, rates)
  * **P2P Marketplace** (publish/borrow/cancel offers with plan-based publishing limits)
* **My Loans** page with status tracking (active, paid, overdue, closed), upcoming payments, and repay actions.
* Credit score policy with tiers controlling:
  * max new loan amount
  * max active loans
  * P2P borrowing access
* Overdue-aware restrictions and due reminder modal for better repayment flow.

#### 🪙 Crypto Trading Module

* Integrated market view with configurable coin list.
* Buy/sell actions inside banking UI.
* Portfolio and trade history tracking.
* Chart/range controls and market update cycle support.
* Plan-based crypto restrictions enforced server-side.

#### 📊 Analytics and Insight Layer

* KPI cards for monthly income, expenses, net cashflow, and savings rate.
* Cashflow trend ranges (30d/14d/7d).
* Spending breakdown with visual distribution (income/spending/transfers).
* Top spending categories and contextual insight cards.
* Dashboard revenue chart and summary metrics tied to real transaction data.

#### 🔔 Updates, Notifications, and Personal Settings

* **My Updates** feed with unread/read state, category filters, mark-read actions, and counters.
* In-app notification controls by category (transfer/plan/loan/support/in-app).
* Privacy mode (streamer-safe masking of sensitive values).
* Security controls (session lock timing, ATM PIN requirement toggle).
* Interface preferences (default landing page, reduced motion, compact mode).

#### 🔌 Framework and Developer Integration

* Framework runtime abstraction for **ESX, QBCore, Qbox** from one codebase.
* Billing bridge and financial logging exports for external scripts.
* Public exports:
  * `AddIncome(target, amount, label)`
  * `AddExpense(target, amount, label)`
  * `AddBillingEntry(target, payload)`
* Automatic database table/column migrations on startup.
* Locale + currency formatting controls for easy regional adaptation.