API Modul · Kreditní infrastruktura

Digitální správa kreditů a školní mikroplatby

Systém správy kreditů UnhostCampus nahrazuje hotovostní platby a složité bankovní převody za drobné položky elegantním API pro virtuální peněženky. Studenti a zaměstnanci platí za stravování, tisk i školní pomůcky jednoduchým přiložením karty k terminálu.

REST API

Endpointy pro dotaz zůstatku, rezervaci částky a zaúčtování transakce v reálném čase.

Webhook

Asynchronní notifikace o stavu kreditu pro napojené informační systémy školy.

Export

Strukturované výstupy tržeb a pohybů kompatibilní s běžnými účetními programy.

01 · Účetní základ

Virtuální peněženky pro každého studenta

Každý uživatelský profil v systému UnhostCampus obsahuje dedikovaný kreditní účet, který slouží jako centrální bod pro všechny vnitroškolní transakce. Rodiče mohou tyto účty dobíjet pomocí standardních platebních metod a prostředky jsou okamžitě k dispozici pro potřeby studenta.

Tento přístup učí žáky finanční zodpovědnosti v bezpečném a kontrolovaném prostředí, kde je riziko ztráty peněz prakticky nulové. Místo hotovosti v kapse nese žák jednu identifikační kartu, která je napojená na jeho profil a kreditní zůstatek v databázi.

GET /api/v1/wallets/{student_id}
Student přikládá identifikační kartu k platebnímu terminálu
Moderní školní jídelna s výdejním pultem
02 · Stravování

Automatizace plateb za stravování

Jídelny jsou nejčastějším místem využití našeho kreditního systému, kde rychlost odbavení přímo ovlivňuje plynulost školního dne. API UnhostCampus se integruje se čtečkami u výdejních pultů a automaticky odečítá správnou částku podle typu strávníka a zvoleného menu.

Systém zároveň hlídá nároky na dotované obědy a zabraňuje dvojímu odběru jídla, čímž chrání rozpočet školy i zákonných zástupců. Obsluha u pultu vidí jen potvrzení úspěšné platby — veškeré rozhodování o ceně a slevách probíhá na úrovni API bez jejího zásahu.

03–04 · Samoobslužné služby

Tisk, kopírování a kroužky v jednom systému

Kreditní účet funguje jako univerzální platební médium napříč celým areálem. Škola definuje ceník služeb jednou a každé prodejní místo načítá aktuální sazby přes stejné rozhraní.

Samoobslužné tiskové a kopírovací služby

Propojení kreditního systému s tiskovým serverem umožňuje studentům využívat školní tiskárny bez asistence personálu. Poplatek za každou vytištěnou stránku se automaticky strhne z kreditu uživatele v momentě autorizace tisku jeho identifikační kartou.

Škola tak efektivně pokrývá náklady na spotřební materiál a zároveň motivuje studenty k šetrnějšímu přístupu k tisku dokumentů, protože vidí přímou souvislost mezi počtem stran a zůstatkem na účtu.

Správa volitelných kroužků a aktivit

Školy často organizují nadstavbové aktivity, které vyžadují dodatečné platby — kurzy, výlety nebo pronájmy sportovišť. UnhostCampus umožňuje definovat tyto aktivity v systému a automaticky zpracovávat platby od přihlášených účastníků bez ručního párování plateb.

Administrátoři mají k dispozici okamžitý přehled o tom, kdo již zaplatil a kolik prostředků bylo na danou aktivitu celkem vybráno. evidence plateb je zpětně dohledatelná pro případ reklamace nebo vrácení poplatku.

05 · Bezpečnost

Bezpečnost a kontrola transakcí

Všechny operace s kredity jsou logovány s vysokou přesností a uživatelé mají k dispozici historii svých pohybů na účtu pro zpětnou kontrolu. V případě ztráty identifikačního média lze kreditní účet okamžitě zmrazit, čímž se zabrání zneužití zbývajících prostředků cizí osobou.

Systém také umožňuje nastavení denních limitů pro útratu, což rodičům dává větší kontrolu nad tím, jak jejich děti s penězi nakládají. Každá změna limitu nebo zmrazení účtu se propíše do auditní stopy a zůstává dohledatelná pro správce i zákonné zástupce.

  • Okamžité zmrazení účtu při nahlášení ztráty karty — zbytek kreditu zůstává chráněn.
  • Denní limity útraty konfigurovatelné podle ročníku nebo skupiny uživatelů.
  • Úplná historie transakcí dostupná přes API i v administrátorském rozhraní.
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

Propojení s účetnictvím, tarify a upozorněními

Export dat pro účetní systémy

Efektivní správa financí vyžaduje bezproblémové propojení s účetním softwarem školy, což naše API plně podporuje prostřednictvím strukturovaných exportů. Data o tržbách a pohybech na kreditních účtech lze periodicky přenášet do externích systémů.

Podporujeme formáty kompatibilní s nejrozšířenějšími ekonomickými programy na trhu, což usnadňuje roční uzávěrky a audity a eliminuje chyby z ručního přepisování dat mezi systémy.

Flexibilní nastavení tarifů a slev

Administrátoři mohou definovat různé cenové hladiny pro různé skupiny uživatelů — slevy pro sourozence, zaměstnanecké benefity nebo dotované sazby pro sociálně slabší rodiny. Tato flexibilita umožňuje škole realizovat komplexní cenovou politiku bez složitého programování.

Změny cen se projeví v celém systému okamžitě po uložení konfigurace, což zajišťuje konzistenci napříč všemi prodejními místy — od jídelny po kopírku.

Upozornění na nízký stav kreditu

Aby nedocházelo k situacím, kdy student u pokladny zjistí nedostatek prostředků, obsahuje systém automatický notifikační modul. Jakmile zůstatek na účtu klesne pod stanovenou hranici, systém zašle upozornění rodičům nebo uživateli prostřednictvím e-mailu či napojené aplikace.

Tím je zajištěna kontinuita služeb a minimalizují se nepříjemné situace při výdeji stravy nebo jiných placených služeb. Hranici upozornění nastavuje správce školy podle lokálních potřeb.

UnhostCampus je poskytovatel databázového softwaru, nikoliv banka. Virtuální kredity představují interní záznamy v informačním systému školy a nejsou peněžními prostředky ve smyslu zákona o platebním styku. Provozovatelem platformy je Základní škola Unhošť.