> For the complete documentation index, see [llms.txt](https://wiki.qfdevelopers.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.qfdevelopers.com/scripts/banking-v2/features.md).

# Features

Page dedicated to what our Banking \[V2] does in game

## Branches

A player walks up to the teller of a branch. When conversations are on, the teller turns to them, greets them with the game's own voice and offers what the bank can do: open the bank, take a number for the counter, answer questions the owner wrote, or show the bank's own people the way to the management office. Outside opening hours a guard (or nobody) stands at the counter.

The bank opens on a tablet in the bank's colours. The player signs in by holding a finger on the round reader, and the bank greets them with their character photo. A player who is not a client of this bank gets a screen that says so and offers what they can do from outside: move their account here, open a personal account, apply for a job or read the bank's fees and products.

| Page          | What the client does there                                                                                    |
| ------------- | ------------------------------------------------------------------------------------------------------------- |
| **Overview**  | Balance, income and spending over time, recent operations.                                                    |
| **Transfers** | Sends money by account number, with saved recipients. Large transfers need a one-time code sent to the owner. |
| **History**   | Every operation, searchable by title, account number or type.                                                 |
| **Cards**     | Issues, blocks and unblocks cards and changes the PIN.                                                        |
| **Products**  | Opens savings accounts, term deposits and loans, checks their credit rating.                                  |
| **Services**  | The counter queue, statements, checkbooks and cheques, deposit boxes.                                         |
| **Bills**     | Fines and invoices addressed to them.                                                                         |
| **Banks**     | Every bank with its fees, the route to it and moving the account there.                                       |
| **Work**      | Their job at the bank, job offers, applications, the desk, the vault and convoy jobs.                         |

The island at the top of the tablet searches every page and action (click it or press Ctrl K), and nothing runs on a single click. Removing a saved recipient, leaving the queue, buying, cashing or voiding cheques, renting or paying for a deposit box or ordering a new key, withdrawing an exchange offer and, in the management office, listing a bank for sale, taking it off the market, rejecting an offer or cancelling a vault order each open a dialog with the details first. Buying a checkbook and paying for a deposit box (rent, overdue rent or a new key) are confirmed with the fingerprint.

### Accounts

Every character has one main account with a number such as `QF-4821-0937`. Next to it a player can open up to three personal accounts (**Admin → General → Limits**), each with its own name, number, balance, history, cards and statements. Moving the main account to another bank keeps its number, balance, cards and history.

### Savings, deposits and loans

Each bank sets its own offer within the regulator's limits. Savings earn interest on the lowest balance held in the period. Term deposits block the amount until their end date. Loans have instalments taken from the main account every period, need a minimum credit rating and an account of a minimum age, and are approved by the bank's staff. A missed instalment adds a penalty and lowers the rating; repeated misses go to collection.

### Cheques and deposit boxes

A checkbook writes cheques to a named player, cashed at any branch while the drawer has the money. A deposit box is a stash in a branch, opened at its box wall with a key; an unpaid box is sealed until the debt is paid.

## ATMs

ATMs work with the card item and its PIN (or with the player's cards from the bank, on inventories without metadata). The player walks up to the machine and faces it, then withdraws, deposits, checks the balance, changes the PIN or prints a receipt. A card locks after the set number of wrong PINs.

ATMs of private banks hold real cash. Staff refill them with cassettes packed from the branch vault, and an empty ATM pays nothing out.

{% hint style="info" %}
**ATM on the machine's screen** (Admin → ATMs, off by default): the camera moves in and the ATM runs on the prop's own screen, with the mouse and keyboard working on it, instead of a window.
{% endhint %}

## Banks as Businesses

### Bank exchange

Banks are bought and sold at the bank exchange (a broker ped placed in **Admin → Branches**). Its terminal shows the map of every bank, branch and ATM, the banks on offer with their price, and each bank's sheet: its story, what it is today and the register of its owners. From there a player buys a bank from the state (the price plus an opening capital put into its treasury), buys one listed by a player, bids at an auction or makes an offer for an unlisted bank. Every purchase is signed on a contract.

### Management office

Each bank is run at its own management office, at a receptionist or at a desk monitor. The owner and managers sign in with the fingerprint and get the management tablet:

| Module            | What it does                                                                                                  |
| ----------------- | ------------------------------------------------------------------------------------------------------------- |
| **Overview**      | Supervision (reserve, loans, unpaid periods), treasury over 30 days, result, staff, clients, ATMs.            |
| **Finance**       | Add capital, take profit, salaries and treasury operations.                                                   |
| **Offer**         | The bank's products. Changes worse for clients apply after the notice period and clients are told.            |
| **Loans**         | Applications to approve or refuse, and the loan book.                                                         |
| **Staff**         | Hire players nearby with a signed contract, set position and salary, bonuses, suspensions, notes, letting go. |
| **Roles**         | Positions, their hierarchy level and salary range.                                                            |
| **Counter**       | Benefits staff may give their clients, by role, and the bonus per client served.                              |
| **Vault**         | Stock of every branch vault, supply orders and the vault history.                                             |
| **ATMs**          | Cash in every ATM and the cassettes on the road.                                                              |
| **Opening hours** | Hours of each branch.                                                                                         |
| **Questions**     | Questions and answers the bank's staff ped gives clients.                                                     |
| **Branding**      | Name, logo, colours, story, map marker and recruiting.                                                        |
| **Sale**          | List the bank for a fixed price or auction, answer offers.                                                    |
| **Journal**       | Everything that happened in the bank.                                                                         |

The `bank_tablet` item opens the same tablet anywhere (Admin → Services).

### Staff and the counter

Employees go on duty and are paid from the treasury every pay period. At the counter they call the next client from the queue, serve them on their own desk and can give the benefits their role allows (lower fees, a better loan or deposit rate, a free card on the spot, a higher cash limit), earning a bonus per client. An owner may leave a branch's counter to staff only; the teller ped then only answers questions. With job sync on (**Admin → Roles and pay**) staff get the framework job `banker` with a grade from their role.

### Supervision and insolvency

The regulator sets a mandatory reserve: below it, a bank cannot lend or take profit. A bank that leaves its obligations unpaid for the set number of periods is declared insolvent and the state closes it: owed salaries are paid first, clients get their money back (interest the bank owes up to the state guarantee), main accounts and loans move to the state bank, staff are let go and the owner loses the bank.

## Cash, Vaults and Convoys

Every branch vault holds physical stock: cash, cards, checkbooks, cassettes, contract forms and box keys. A branch with an empty vault cannot serve that item. Vaults are restocked from the central bank in two ways:

* **Central bank delivery**: pricier, arrives on its own after a set time (12 hours by default).
* **Own convoy**: the bank's staff drive it. The order appears in the Work page of on-duty staff; a crew picks up the armoured van at the convoy depot, carries the crates from the pallet, stows them in the van by hand, drives to the branch, unloads them at the vault and returns the van. A task panel shows each step and the time left, and every crew member gets the bonus the owner set.

Cargo can be insured against a failed run. Insurance never covers a robbery.

{% hint style="info" %}
The whole crew gets the keys of the van at the depot. Eleven popular key scripts are supported out of the box and your own is connected in a few lines (see [Vehicle keys](https://wiki.qfdevelopers.com/scripts/banking-v2/configuration.md#vehicle-keys)).
{% endhint %}

## Robberies

Banking V2 has no robbery minigame for ATMs and vaults. It gives your robbery scripts exports that take real cash from an ATM, a branch vault or a stolen cassette, with police count, cooldowns and alerts set in **Admin → Robberies** (see [Additional Informations](https://wiki.qfdevelopers.com/scripts/banking-v2/additional-informations.md#developer-api-exports-and-events)).

**Convoy robbery is built in.** Behind a stopped convoy van, a player with an explosive item (`thermite` or `c4` by default) sets a charge on the rear doors. After the fuse the doors blow off and everyone there fills a `bank_loot_bag` from each cash crate. Opening the bag pays dirty money. The bank owes the central bank the stolen banknotes.

## Billing

Billing is built in and replaces our Billing System. Players see and pay their fines and invoices in a branch, with `/billing`, the `billing_tablet` item or a phone app, from their main account.

Members of a billing faction (police, EMS, mechanics and the court by default) open the faction screen with the `ticket_book` item or `/ticketbook`: they pick a player standing nearby, add lines from the faction's tariff the way charges are added in our MDTs, sign, and the bill is issued. Payments go to the faction's society account. Higher grades edit the tariff and see the faction's income. Unpaid bills get reminders, a late fee, a mark in the credit history and, optionally, are paid automatically after some days.

### Sale contracts

Players sell a vehicle, a property or items to each other with a contract written in **Billing → Contracts**, at a branch or anywhere with a blank `sale_contract`. Both sign; the price is held in escrow until the subject changes hands, and the buyer of a vehicle gets a `vehicle_title`. Properties appear once your housing script is connected in `server/editable.lua` (commented examples for qs-housing, ps-housing and loaf\_housing).

### Taxes

VAT on invoices, income tax on salaries, transfer tax, a weekly wealth tax and a weekly bank ownership fee, each with its own switch and rate in **Admin → Economy → Taxes**. Everything collected goes to the central bank.

### MDT tablets

Our Police, DOJ, Ambulance and Mechanic MDT \[V2] can use the bank's tariff and issue their fines and invoices through the bank. It is off by default on both sides: turn on the tablet in **Admin → Billing → Service tablets** and the integration switch in the MDT's own config. The MDT's existing tariff can be copied with one click.

## Papers

Statements, contract copies, cheques, vehicle titles, ATM receipts and bills are inventory items. Using one makes the character hold the paper up, and it appears on screen for the holder and everyone within reach who can see them, like the documents of our MDTs. The holder can press E to read it closely. Cheques, titles and bills are read live, so a cashed cheque or a paid fine shows its stamp.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wiki.qfdevelopers.com/scripts/banking-v2/features.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
