API module · Credit infrastructure

Digital credit management and school micropayments

The UnhostCampus credit-management system replaces cash handling and fiddly bank transfers for small campus items with an API for virtual wallets. Students and staff pay for meals, printing and school supplies by tapping a card on a terminal. Those wallets hold internal credits — not cash.

REST API

Endpoints for balance lookup, amount reservation and posting a ledger event in real time.

Webhook

Async notifications of credit state for connected school information systems.

Export

Structured exports of takings and movements compatible with common accounting packages.

01 · Ledger base

Virtual wallets for every student

Every user profile in UnhostCampus has a dedicated credit account that is the hub for on-campus ledger events. Parents can top up these internal-credit accounts through the school’s existing payment partners; the ledger balance is then available immediately. UnhostCampus does not take or hold fiat.

This approach teaches pupils financial responsibility in a safe, controlled setting where the risk of losing cash is practically zero. Instead of cash in a pocket, the pupil carries one ID card linked to their profile and credit balance in the database.

GET /api/v1/wallets/{student_id}
A student tapping an ID card on a payment terminal
A modern school canteen with a serving counter
02 · Catering

Automated meal payments

Canteens are the most common place our credit system is used, and queue speed shapes the school day. The UnhostCampus API talks to readers at serving counters and deducts the right internal-credit amount by diner type and chosen menu.

The system also checks entitlement to subsidised lunches and blocks double collection, protecting the school budget and guardians. Staff at the counter only see a successful-payment confirmation — price and discount logic stays in the API.

03–04 · Self-service

Print, copy and clubs in one system

The credit account works as a campus-wide internal-credit medium. The school defines a price list once and every point of sale reads current rates through the same API.

Self-service print and copy

Linking the credit system to the print server lets students use school printers without staff help. The charge for each printed page is deducted from the user’s internal credits when their ID card authorises the job.

The school covers consumable costs more cleanly, and students print more carefully because they see the link between page count and remaining credit.

Optional clubs and activities

Schools often run extra activities that need extra charges — courses, trips or sports-hall hire. UnhostCampus lets you define those activities and post internal-credit charges for enrolled participants without matching bank payments by hand. Fiat still moves through the school’s existing partners.

Administrators get an instant view of who has already paid and how much internal credit has been collected for that activity. Payment records are auditable if a complaint or refund is needed.

05 · Security

Transaction security and control

Every credit operation is logged in detail and users can review their own ledger history. If an ID medium is lost, the credit account can be frozen at once so remaining internal credits cannot be spent by someone else.

Daily spend limits can be set, giving parents more control over how children use internal credits. Every limit change or freeze is written to the audit trail and remains visible to administrators and guardians.

  • Instant account freeze when a lost card is reported — remaining credit stays protected.
  • Daily spend limits configurable by year group or user group.
  • Full transaction history available through the API and the admin interface.
POST /api/v1/wallets/freeze
{
“student_id”: “UC-2026-0847”,
“action”: “freeze_balance”,
“reason”: “lost_card_reported”,
“authorized_by”: “admin@skola.cz”
→ status: 200 OK
response: “account_frozen”
06–08 · Integrace a konfigurace

Accounting links, tariffs and alerts

Export for accounting systems

School accounting needs a clean feed from the ledger. Our API supports that with structured exports. Takings and movements on credit accounts can be transferred periodically into external systems.

We support formats used by the most common economic packages, which eases year-end close and audits and removes copy-paste errors between systems.

Flexible tariffs and discounts

Administrators can define price levels per user group — sibling discounts, staff benefits or subsidised rates for families in need. The school can run a complex price policy without custom programming.

Price changes apply campus-wide as soon as the configuration is saved, so the canteen and the copier stay in sync.

Low-credit alerts

To avoid a student discovering a short balance at the till, the system can send alerts. When the account falls below a threshold, parents or the user are notified by email or a connected app.

That keeps services running and reduces awkward moments at meal issue or other charged services. The school administrator sets the alert threshold.

UnhostCampus is a database-software provider, not a bank. Virtual credits are internal records in the school information system and are not funds under the Payment System Act. The platform is operated by Základní škola Unhošť.