Development

Integration Flow

External Resource
      │
      ├── rs_bank exports ───── Player and business banking
      ├── rs_billing exports ── Invoice lookup and payment
      │
      └── rs_mobile_bank ────── LB Phone frontend using both systems

RS Bank Server Exports

Get a Player’s Bank Balance

local balance = exports['rs_bank']:GetBankBalance(source)

Add Money to a Player

local success, newBalance = exports['rs_bank']:AddMoneyToBank(
    source,
    2500,
    'Payslip: Police Department'
)

Remove Money from a Player

local success, newBalance = exports['rs_bank']:RemoveMoneyFromBank(
    source,
    500,
    'Vehicle Registration Fee'
)

Read and Update Credit Score

local score = exports['rs_bank']:GetCreditScore(source)

-- Positive or negative adjustment
exports['rs_bank']:UpdateCreditScore(source, 5)
exports['rs_bank']:UpdateCreditScore(source, -10)

Business Funds

exports['rs_bank']:AddBusinessMoney(
    'police',
    5000,
    'Government Funding',
    citizenid
)

exports['rs_bank']:RemoveBusinessMoney(
    'police',
    1000,
    'Equipment Purchase',
    citizenid
)

local businessBalance = exports['rs_bank']:GetBusinessMoney('police')

Log a Custom Transaction

exports['rs_bank']:LogTransaction(
    citizenid,          -- Use BUSINESS_jobname for business history
    'custom_payment',   -- Transaction type
    750,                -- Amount
    balanceAfter,
    'Custom Service Payment',
    relatedCitizenId
)

RS Bank Client Exports

These callbacks are used internally by rs_mobile_bank and can also support custom interfaces.

exports['rs_bank']:GetBankData(function(data)
    print(json.encode(data))
end)

exports['rs_bank']:Transfer(transferData, function(result)
    print(result.success)
end)

exports['rs_bank']:Deposit(amount, accountId, function(result)
    print(result.success)
end)

exports['rs_bank']:Withdraw(amount, accountId, function(result)
    print(result.success)
end)

exports['rs_bank']:VerifyPIN(pin, function(result)
    print(result.success)
end)

Additional client exports include:

GetTransactions(callback)
GetAccountTransactions(accountType, accountId, callback)
UpdateCardStyle(data, callback)
IsBankOpen()
IsATMOpen()

RS Billing Server Exports

Billing exports are available when Config.EnableExports = true.

Get Unpaid Invoices

local invoices = exports['rs_billing']:GetUnpaidInvoices(citizenid)

Pay an Invoice

local result = exports['rs_billing']:PayInvoice(citizenid, invoiceId)

if result.success then
    print(('Paid %s'):format(result.amount))
end

The player must be online for payment because the export validates and removes their live bank balance.

Get an Invoice

local invoice = exports['rs_billing']:GetInvoiceById(invoiceId)

Get Bills for a Banking Interface

local bills = exports['rs_billing']:GetBillsForBank(citizenid)

Get Configured Categories

local categories = exports['rs_billing']:GetCategories()

Editable Bridge Files

Use these files when integrating a custom framework, inventory, target, business-management, or phone resource.

Resource	File	Purpose
`rs_bank`	`server/framework.lua`	Server-side framework wrapper
`rs_bank`	`client/framework.lua`	Client-side framework wrapper
`rs_bank`	`client/target.lua`	Bank and ATM target logic
`rs_bank`	`shared/inventory.lua`	Custom receipt and check inventory bridge
`rs_bank`	`shared/phonemail.lua`	Phone mail and notification bridge
`rs_billing`	`server/framework.lua`	Server-side framework wrapper
`rs_billing`	`client/framework.lua`	Client-side framework wrapper
`rs_billing`	`shared/phonemail.lua`	Invoice notification bridge
`rs_billing`	`bridge/rs_bank.lua`	Banking and credit-score connection

Custom Framework Notes

Both core resources contain custom framework branches, but those branches are placeholders. A custom framework requires you to implement the expected player, callback, money, item, and notification functions in the editable framework bridge files.