# 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="" %} ### Showcase {% embed url="" %} ### 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ambr4-scripts.gitbook.io/docs/scripts/banking-system.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.