Teller & Cash Operations - Nucleus Core Banking

Teller operations control over-the-counter physical cash handling at the branch level.

Key Rules

Till Allocation: A Teller must have an allocated, open cash till tied to their user ID and branch before posting cash transactions.
Four-Eyes Principle on Cash: Cash withdrawals exceeding the teller’s single-transaction ceiling (e.g. > ₦500,000) require on-the-spot checker approval from the Branch Manager (Role 320007) or Branch Head of Operations.

1. Cash Deposit (Cash-In)

POST /nucleus/api/v1/savingsaccounts/12/transactions?command=deposit&tenantIdentifier=pilot-mfb
Content-Type: application/json

{
  "transactionDate": "12 September 2026",
  "transactionAmount": 100000.00,
  "paymentTypeId": 1,
  "dateFormat": "dd MMMM yyyy",
  "locale": "en"
}

GL Accounting Posting:

Debit: Cash in Hand / Teller Till (GL 11101)
Credit: Customer Savings Liability (GL 21101)

2. Cash Withdrawal (Cash-Out)

POST /nucleus/api/v1/savingsaccounts/12/transactions?command=withdrawal&tenantIdentifier=pilot-mfb
Content-Type: application/json

{
  "transactionDate": "12 September 2026",
  "transactionAmount": 50000.00,
  "paymentTypeId": 1,
  "dateFormat": "dd MMMM yyyy",
  "locale": "en"
}

3. End-of-Day Till Balancing

At branch closing, the teller reconciles physical cash against the system balance and submits the till closure:

POST /nucleus/api/v1/cashiers/{cashierId}/settle?tenantIdentifier=pilot-mfb
Content-Type: application/json

{
  "endDate": "12 September 2026",
  "dateFormat": "dd MMMM yyyy",
  "locale": "en"
}