Server Events
kartik-banking fires these events on the server so your scripts (logging, audit webhooks, economy tools) can react to money moving. Listen with AddEventHandler in any server script. Players cannot trigger them.
Each event fires only after the money has moved or the record is saved. Every payload includes timestamp (unix seconds). Fields that do not apply to an action are nil.
AddEventHandler('kartik-banking:server:onDeposit', function(data)
print(('$%d deposited into account %s'):format(data.amount, data.accountNumber))
end)onDeposit
kartik-banking:server:onDeposit: a deposit at a bank or ATM, or CreditAccount.
| Field | Description |
|---|---|
origin | 'bank', 'atm' or 'export' |
source | Player server id (when a player did it) |
accountNumber | Account the money went into |
accountType, owner | Account type and owner (export deposits) |
cardNumber | Card used (bank / ATM deposits) |
bankType | 'fleeca' or 'swiss' |
amount | Amount |
reason | Note / reason |
onWithdraw
kartik-banking:server:onWithdraw: a withdrawal at a bank or ATM, or DebitAccount. Same fields as onDeposit.
onTransfer
kartik-banking:server:onTransfer: any account to account transfer (players, invoices, POS, loans).
| Field | Description |
|---|---|
source | Player server id, nil when the system moved it |
fromAccount, toAccount | Account numbers |
bankType | 'fleeca' or 'swiss' |
amount | Amount |
reason | Note / reason |
onInvoiceCreated
kartik-banking:server:onInvoiceCreated: an invoice / bill is created.
| Field | Description |
|---|---|
invoiceId | New invoice id |
accountNumber, accountType, owner | Who is billed |
issuerAccountNumber | Who gets paid (if set) |
senderName | Sender |
amount | Amount (per installment for EMI) |
title | Title |
billType | 'one-time', 'subscription' or 'emi' |
frequency, nextDue | Billing schedule |
onInvoicePaid
kartik-banking:server:onInvoicePaid: an invoice payment succeeds (manual or autopay).
| Field | Description |
|---|---|
invoiceId | Invoice id |
accountNumber, owner | Who paid |
issuerAccountNumber | Who got paid (if set) |
amount | Amount paid |
title | Title |
billType | 'one-time', 'subscription' or 'emi' |
onInvoiceCancelled
kartik-banking:server:onInvoiceCancelled: an invoice is cancelled with CancelInvoice. Fields: invoiceId, accountNumber, issuerAccountNumber, amount, title, reason.
onPosPayment
kartik-banking:server:onPosPayment: a POS terminal payment completes.
| Field | Description |
|---|---|
transactionId | POS transaction id |
businessName, businessAccount | The business that was paid |
businessSource, customerSource | Employee and customer server ids |
amount | Amount charged |
fee, netAmount | Transaction fee and amount after the fee |
paymentMethod | How the customer paid |
reason | Reason entered on the terminal |