Osnova: 1. Principy Univerzitní elektronické peněženky UEP 2. Smlouva s partnerem specifikace dodatku číslo 4 3. Výměna uživatelských dat o strávnicích mezi ČZU a partnerem 4. Komunikační protokol s pokladnami partnera Stručný popis platebního systému ČZU Uživatelem UEP (Univerzitní Elektronické Peněženky) je student, zaměstnanec a host ČZU. Do UEP na kartě typu Philips MIFARE DESFire uživatel vkládá peníze. o Student a host musí pro užívání UEP nejprve peníze na kartu vložit. Není mu umožněno využívat záporný zůstatek na kartě. o Zaměstnanec může využívat elektronickou peněženku stejným způsobem jako student nebo host, ale je mu umožněno dosáhnout záporného zůstatku na kartě do omezené výše. Informace o maximálním povoleném záporném zůstatku na kartě pro zaměstnance je zapsána přímo na kartě a je možné ji změnit pouze na Hlavní pokladně ČZU. Přednastavená hodnota jako Default je mínus 2.000,- Kč. Záporný zůstatek evidovaný v Clearingu k půlnoci posledního dne každého kalendářního měsíce každého zaměstnance (skutečný záporný zůstatek na kartě potvrzený na základě sběru dat) je zúčtováván ke stržení ze mzdy zaměstnance. Po potvrzení zúčtování mzdovým systémem je částka strhávána ze mzdy a připravena k nahrání (dobití) do UEP na JUMBO účtu. Nahrávání těchto částek probíhá na Dobíjecích automatech. Aplikace UEP je nahrávána pouze na vizuálně a datově personalizované karty ČZU. Nepersonalizované karty slouží pouze k přístupu do budov. Klient při odběru služby nebo zboží (platby za stravu, kolejné, kopírování, studijní poplatky, knihovní poplatky, pronájem zařízení a vybavení, atd.) přiloží kartu k akceptačnímu zařízení, kterým je částka stržena přímo z karty, a které pracuje v režimu offline. Vkládání peněz do UEP je možné na třech pokladnách ČZU a v šesti hotovostních Dobíjecích automatech a ve dvou bezhotovostních. Peníze je možné vkládat na karty pouze na místech pod přímou správou ČZU. Výběry peněz z karet a storno operace je možné z bezpečnostních důvodů realizovat pouze na Hlavní pokladně ČZU. Jestliže by držitel karty měl překročit maximální nastavenou zápornou hodnotu v UEP na kartě ČZU (student a host 0,- Kč), potom mu systém neumožní provést platbu, po jejíž realizaci by byla záporná hodnota na kartě nad povolenou hodnotu. Aby držitel karty mohl dále používat elektronickou peněženku na kartě, musí vložit do UEP na kartě peníze (v hotovosti na pokladně, v hotovosti v Dobíjecím automatu, bezhotovostně srážkou ze mzdy nebo bezhotovostně převodem z účtu).
Peněžní hodnota je na kartě uložena na dvě desetinná místa z důvodu přechodu na měnu EUR. V současném použití pro CZK není možné využívat haléře. Při nefunkčnosti karty určuje HELPDESK OIKT, zda je karta poškozena neodbornou manipulací způsobenou držitelem karty nebo se jedná o výrobní vadu karty, či je závada způsobena běžným opotřebením. Dle tohoto rozhodnutí je výměna karty hrazena držitelem karty, na základě reklamace nebo ČZU. Pro debetní transakce (vybití UEP, tj. platby) mohou být obsluhou (pokladní) na vyžádání držitele karty tištěny stvrzenky s uvedením úplného čísla karty, odečtené částky z UEP a s uvedením původního stavu a konečného stavu UEP před a po provedení transakce. Stvrzenky jsou tištěny bez ochranných prvků (kotoučky do tiskáren zařízení jsou pořizovány v čistě bílém provedení). Kotoučky jsou pořizovány partnerem ČZU na jeho vlastní náklady. Storno operace jsou prováděny výhradně na Hlavní pokladně ČZU, v případě nefunkčnosti Hlavní pokladny ČZU pak na záložním řešení na oddělení HELPDESK OIKT. Na každé účtence (stvrzence) týkající se transakcí s elektronickou peněženkou je uvedeno úplné číslo karty ČZU z důvodu případné rekonstrukce dat v případě výpadku systému. Maximální hodnota UEP na kartě je 4.500,- Kč. Limity pro výběr peněz z UEP v hotovosti nejsou stanoveny. Výběr peněz v hotovosti z UEP na kartě více než jednou denně musí schválit nadřízený orgán ČZU. Limity pro vybití (výši platby provedené elektronickou peněženkou) nejsou stanoveny. Nedokončené transakce (například nesoulady dat na kartě s logy) jsou řešeny na oddělení HELPDESK OIKT nebo v Kartovém centru. Držitel UEP si může stanovit libovolnou výši platby, od které je nutné použít 6-ti místný PIN. Specifikace dodatku číslo 4 ke smlouvě s partnerem Příloha číslo 1. Výměna uživatelských dat o strávnicích mezi ČZU a partnerem ČZU zasílá ze svého Card Managementu partnerovi data o strávnících. Zejména jméno, příjmení, UID čipu karty, zařazení do skupiny strávníků (nároky na dotace na stravu), Univerzitní Identifikační Číslo (UIČ). Tato data jsou vždy zasílána z podnětu ČZU. Data jsou vyměňována prostřednictvím webových služeb a souborů ve formátu XML. Partner potvrzuje správnost přijetí každé jednotlivé věty odesláním potvrzujícího souboru ve formátu XML. Komunikační protokol s pokladnami partnera K pokladnám partnera jsou prostřednictvím sériového portu RS232 připojeny platební terminály Vega 7000, na kterých probíhají operace s UEP. Nastavení sériového portu je uvedeno v příloze číslo 2. Po přiložení karty UEP k terminálu Vega 7000 tento zašle prostřednictvím sériové linky do pokladny partnera peněžní zůstatek v UEP, maximální záporný limit karty a UID čipu karty dle přílohy číslo 2.
Pokladna do 100 milisekund otevře účet pro daného strávníka s danými slevami. Pokladní namarkuje stravu, uzavře účet a pokladna odešle částku k platbě dle přílohy číslo 2. Terminál Vega 7000 odečte částku z karty UEP a potvrdí pokladně její odečtení způsobem dle přílohy číslo 2. Pokladna do 50 milisekund potvrdí terminálu Vega 7000 přijetí této zprávy opět způsobem dle přílohy číslo 2. Tím je transakce ukončena. Bližší popis komunikace je uveden v příloze číslo 2. Příloha číslo 2.
Popis protokolu TMX008 Ver. dokumentu 1.1
Seznam revizí Datum Verze Popis 9.11.2009 1.0 První verze dokumentu 11.2.2010 1.1 Doplněna varianta protokolu TMX008.2 Neveřejný dokument 2 / 9 Verze dokumentu 1.1
Obsah SEZNAM REVIZÍ...2 OBSAH...3 1. POPIS PROTOKOLU...4 1.1. OBECNÝ POPIS... 4 1.2. FORMÁT ZPRÁV... 4 1.3. SEZNAM ZPRÁV... 4 1.4. STAVOVÝ DIAGRAM... 5 1.5. JEDNOTLIVÉ ZPRÁVY - PŘÍKLADY... 6 1.6. VARIANTA PROTOKOLU TMX008.2... 9 Neveřejný dokument 3 / 9 Verze dokumentu 1.1
1. Popis protokolu 1.1. Obecný popis Dokument popisuje protokol pro vzájemnou komunikaci mezi platebním terminálem Vega 7000 a pokladnou nebo jiným zařízením. Terminál se připojuje pomocí sériové linky RS232 s následujícím nastavením: Komunikační rychlost 9600 Parita Není Počet bitů 8 Počet stopbitů 1 1.2. Formát zpráv Komunikační protokol je textově orientovaný, jednotlivé položky jsou odděleny středníkem a mají pevnou délku. Zpráva je zabezpečena CRC16 kontrolním součtem. Do každé zprávy je před odesláním přidán na začátek start byte STX (0x02) a na konec stop byte ETX (0x03). Start byte ID zprávy Datová část položky mají pevnou délku a za každou položkou je středník CRC textově Stop byte Hodnota 0x02 99; 123456;03;987654321; 88CD 0x03 Délka 1 byte 3 byty n bytů 4 byty 1 byte Toto je pouze ilustrativní příklad, start byte je binární hodnota 0x02, stop byte 0x03, zbývající položky jsou textové řetězce, jednotlivé položky jsou odděleny středníkem, za CRC středník není. 1.3. Seznam zpráv ID Kdo posílá Význam zprávy 01 Terminál Přiložení karty s EP, zahájení transakce 02 Pokladna Požadavek na odečtení částky z EP 03 Terminál Výsledek provedené operace odečtení z EP 04 Terminál Přiložení ID karty Mifare Desfire 05 Terminál Přiložení ID karty Mifare Standard 06 Pokladna Potvrzení zprávy 01 přiložení karty s EP 07 Pokladna Potvrzení zprávy 04 přiložení ID karty Mifare Desfire 08 Pokladna Potvrzení zprávy 05 přiložení ID karty Mifare Standard 09 Pokladna Pokyn k opakování zprávy 03 10 Pokladna Potvrzení zprávy 03, ukončení transakce Neveřejný dokument 4 / 9 Verze dokumentu 1.1
1.4. Stavový diagram Stavový diagram je popisován z pohledu terminálu. Komunikaci zahajuje terminál po přiložení karty odesláním zprávy 01 nebo 04 nebo 05 podle typu přiložené karty. Jsou definovány 3 typy karet: karta Mifare Desfire s elektronickou peněženkou (zpráva 01), ID karta Mifare Desfire (zpráva 04) a ID karta Mifare Standard (zpráva 05). Pokladna přijetí zprávy okamžitě potvrdí odesláním zprávy 06, resp. 07, resp. 08. Pokud terminál nepřijme potvrzení do 300 ms, úvodní zprávu opakuje. Maximální počet opakování je 10, potom přechází terminál zpět do základního stavu. V případě karty s EP po přijetí zprávy 06 čeká terminál na přijetí zprávy 02 s částkou k odečtení. Timeout u zprávy 02 je 300 sekund, aby obsluha pokladny byla schopná zadat částku. Terminál provede odečtení částky z EP, uloží transakci a vytiskne doklad. Zde je třeba počítat s maximálním časem na provedení všech operací 60 sekund (někdy je třeba zadávat i PIN). Pokladna přijetí zprávy okamžitě potvrdí odesláním zprávy 10. Tím se celá transakce ukončí a terminál i pokladna přechází do základního stavu. Pokud pokladna přijme zprávu 03 ve špatném formátu, s chybným CRC apod., posílá zprávu 09 jako požadavek na opakování zprávy 03. Pokud terminál nepřijme zprávu 10 nebo 09 do 3 sekund, přechází do základního stavu. Neveřejný dokument 5 / 9 Verze dokumentu 1.1
1.5. Jednotlivé zprávy - příklady Zpráva 01 ID_message;ID_chip_card;Value;MaxDdebet;CRC Příklad přiložení karty s EP o hodnotě 1000 Kč, povolen debet 0 Kč. Textově 01;8C66B53D000000; 100000; 0;37EE Binárně 30 31 3B 38 43 36 36 42 35 33 44 30 30 30 30 30 30 3B 20 20 20 20 20 31 30 30 30 30 30 3B 20 20 20 20 20 20 20 20 20 20 30 3B 33 37 45 45 Zpráva 02 ID_message;ID_chip_card;Price;CRC Příklad požadavek na odečtení 100 Kč. Textově 02;8C66B53D000000; 10000;55E6 Binárně 30 32 3B 38 43 36 36 42 35 33 44 30 30 30 30 30 30 3B 20 20 20 20 20 31 30 30 30 30 3B 35 35 45 36 Zpráva 03 ID_message;ID_chip_card;Status;Text;CRC Příklad operace, která dopadla v pořádku. Textově 03;8C66B53D000000;00;OK ;53C8 Binárně 30 33 3B 38 43 36 36 42 35 33 44 30 30 30 30 30 30 3B 30 30 3B 4F 4B 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3B 35 33 43 38 Zpráva 04 Příklad přiložení ID karty Desfire. Textově 04;8C66B53D000000;B110 Binárně 30 34 3B 38 43 36 36 42 35 33 44 30 30 30 30 30 30 3B 42 31 31 30 Zpráva 05 Příklad přiložení ID karty Standard. Textově 05;8C66B53D;5B40 Binárně 30 35 3B 38 43 36 36 42 35 33 44 3B 35 42 34 30 Zpráva 06 Příklad potvrzení přiložení karty s EP. Textově 06;8C66B53D000000;90D4 Neveřejný dokument 6 / 9 Verze dokumentu 1.1
Binárně 30 36 3B 38 43 36 36 42 35 33 44 30 30 30 30 30 30 3B 90 D4 Zpráva 07 Příklad potvrzení přiložení ID karty Desfire. Textově 07;8C66B53D000000;8036 Binárně 30 37 3B 38 43 36 36 42 35 33 44 00 00 00 00 00 00 3B 38 30 33 36 Zpráva 08 Příklad potvrzení přiložení ID karty Standard. Textově 08;8C66B53D;70C0 Binárně 30 38 3B 38 43 36 36 42 35 33 44 3B 37 30 43 30 Zpráva 09 Příklad požadavku o opakování zprávy 03. Textově 09;8C66B53D000000;656A Binárně 30 39 3B 38 43 36 36 42 35 33 44 00 00 00 00 00 00 3B 36 35 36 41 Zpráva 10 Příklad ukončení transakce s EP. Textově 10;8C66B53D000000;02A9 Binárně 31 30 3B 38 43 36 36 42 35 33 44 00 00 00 00 00 00 3B 30 32 41 39 ID_message ID_chip_card CRC Typ zprávy, pevná délka 2 znaky (numerické číslice), viz seznam zpráv. Pole 7 bytů vyjádřené hexadecimálním řetězcem v případě zprávy 01, 02, 03, 04, 06, 07, 09 a 10, pevná délka 14 znaků pole 4 bytů vyjádřené hexadecimálním řetězcem v případě zprávy 05 a 08, pevná délka 8 znaků. Je uvedeno v každé zprávě, aby bylo jasné s jakou kartou se provádí transakce. 16-ti bitové CRC16 CCITT x 16 + x 12 + x 5 + 1, počáteční vektor 0xFFFF, počítá se z ID zprávy a datové části zprávy, včetně všech středníků. Neveřejný dokument 7 / 9 Verze dokumentu 1.1
Value MaxDebet Hodnota elektronické peněženky v haléřích, dekadicky, pevná délka 11 znaků (10 číslic + znaménko mínus v případě záporné hodnoty), zarovnáno vpravo, zleva doplněny mezery. Hodnota v haléřích do které je možné přečerpat hodnotu elektronické peněženky do záporných hodnot, dekadicky, pevná délka 11 znaků (10 číslic + znaménko mínus v případě záporné hodnoty), zarovnáno vpravo, zleva doplněny mezery. Použitelná hodnota k úhradě je dána součtem hodnot Value a MaxDebet. Příklady Value MaxDebet Použitelná hodnota 1.500,- 0,- 1.500,- 1.500,- 1.000,- 2.500,- 1.500,- -1.000,- 500,- -500,- 1.000.- 500,- -500,- 0,- Neměla by nastat Price Je hodnota v haléřích, která se má odečíst z elektronické peněženky (větší nebo rovno nule), dekadicky, pevná délka 10 znaků, zarovnáno vpravo, zleva doplněny mezery. Status Pevná délka 2 znaky, celé číslo, dekadicky (0 až 99), doplněno nulami zleva. Text Pevná délka 20 znaků, zarovnáno vlevo, zprava doplněno mezerami. Tabulka návratových stavů Status Text Význam 00 OK Operace dopadla v pořádku, hodnota z peněženky odečtena 10 Neodečteno Hodnota nebyla z peněženky odečtena 11 Karta odejmuta Karty byla odejmuta z terminálu není odečteno 12 Jiná karta Na terminál byla mezitím přiložena jiná karta 13 Nejsou peníze Požadovaná hodnota pro odečet je větší než je možné odečíst 14 Storno Transakce stornována pokladnou, zasláním zprávy 02 s částkou k odečtení 0 Kč Příklady změny hodnoty peněženky po odečtu. Value MaxDebet Použitelná Price Value po odečtení hodnota 1.500,- 0,- 1.500,- 1.000,- 500,- 1.500,- 1.000,- 2.500,- 2.000,- -500,- 1.500,- -1.000,- 500,- 250,- 1.250,- -500,- 1.000.- 500,- 200,- -700,- Neveřejný dokument 8 / 9 Verze dokumentu 1.1
1.6. Varianta protokolu TMX008.2 Formát zpráv zůstává stejný. Změna spočívá v jiném chování terminálu. V případě TMX008.2 se po přiložení karty Mifare Desfire s elektronickou peněženkou odešla zpráva 01, čeká se na potvrzení zprávou 06, ale dál terminál nečeká, že bude probíhat platba. V případě přijetí zprávy 02 (kdykoli), je vyžadováno přiložení karty s elektronickou peněženkou (pokud není přiložena) a provede se odečtení požadované částky. Po provedení všech operací terminál posílá status dokončení zprávou 03 a čeká na potvrzení přijetí zprávou 09 nebo 10. Ve zprávě 02 se ignoruje položka ID_chip_card. Neprobíhá také porovnání čísla karty s číslem karty v poslední zprávě 01, tak jako je to u základní verze protokolu. Ve zprávě 03 terminál v ID_chip_card posílá číslo karty, ze které byla částka odečtena. Neveřejný dokument 9 / 9 Verze dokumentu 1.1