🏛️API & Exports

The SRC Advanced Banking system provides a robust set of exports and events, allowing developers to integrate banking, loans, and credit scoring into their own resources.

Client-Side Exports

Open Bank UI

Opens the main banking tablet or teller interface.

-- mode: 'tablet' or 'atm'
-- atmId: 'teller' or a specific ATM ID (optional)
exports['src-bank']:OpenBank(mode, atmId)

Open Teller

Quickly opens the bank teller interface.

exports['src-bank']:OpenTeller()

Open ATM

Quickly opens the interface for a specific ATM.

exports['src-bank']:OpenATM(atmId)

Close Bank UI

Forcefully closes the banking interface.

exports['src-bank']:CloseBank()

Check if Bank is Open

Returns true if the banking UI is currently active.

local isOpen = exports['src-bank']:IsBankOpen()

Get Closest ATM

Finds the ID of the ATM nearest to the player based on the configuration.

local atmId = exports['src-bank']:GetClosestAtmId()

---

Server-Side Exports

Get IBAN

Retrieves the IBAN associated with a player's citizen ID.

local iban = exports['src-bank']:GetIBAN("CITIZEN_ID")

Get Credit Score

Retrieves the current credit score for a player.

local score = exports['src-bank']:GetCreditScore("CITIZEN_ID")

Update Credit Score

Adjusts a player's credit score by adding or removing points.

-- points: can be positive or negative
exports['src-bank']:UpdateCreditScore("CITIZEN_ID", 10)

Add Transaction

Manually inserts a custom transaction into a player's bank history.

-- citizenid: Target player
-- type: 'deposit', 'withdraw', 'transfer_in', 'transfer_out'
-- amount: Number
-- description: Text to display in the UI
exports['src-bank']:AddTransaction("CITIZEN_ID", "deposit", 500, "Quest Reward")

Society Banking Exports

Manage organization and society bank accounts.

Get Society Balance

Retrieves the current balance of a society account.

-- job: Society job name (e.g., 'police')
local balance = exports['src-bank']:GetSocietyBalance("police")

Add Society Money

Adds money to a society bank account.

-- job: Society job name
-- amount: Number
-- description: Log entry for the society history
local success = exports['src-bank']:AddSocietyMoney("police", 5000, "Fine Revenue")

Remove Society Money

Removes money from a society bank account.

-- job: Society job name
-- amount: Number
-- description: Log entry for the society history
local success = exports['src-bank']:RemoveSocietyMoney("police", 1500, "Equipment Purchase")

Get or Generate Society Account

Retrieves IBAN and balance, or creates the account if it doesn't exist.

local iban, balance = exports['src-bank']:GetOrGenerateSocietyAccount("police")

---

Programmatic Transfer

Performs a bank transfer between two players entirely via script.

-- senderCid: Citizen ID of the sender
-- receiverIbanOrCid: Target IBAN or Citizen ID
-- amount: Number
-- description: Custom log entry (optional)
local success, errorOrBalance = exports['src-bank']:ProgrammaticTransfer("SENDER_CID", "TARGET_CID", 1000, "Contract Payment")

Check Blacklist

Checks if a player is blacklisted from taking out new loans.

local isBlacklisted = exports['src-bank']:IsBlacklisted("CITIZEN_ID")

---

Events

Client Events

src-bank:client:bankRefresh

Triggered whenever the bank data is updated (balance changes, loans paid, etc.). Use this to sync your UI if you have custom banking widgets.

RegisterNetEvent('src-bank:client:bankRefresh', function(data)
    -- data = { success, newBalance, transactions, chartData, message, ... }
end)

src-bank:client:syncBalance

Triggered for minor balance updates.

RegisterNetEvent('src-bank:client:syncBalance', function(balance, cash)
    -- handle balance update
end)

---

Developer Tip: Use ProgrammaticTransfer when you want to ensure both players get a transaction log entry and the corresponding money is moved safely across frameworks (QBCore/ESX).