TicketMagic — Felhasználói kézikönyv

Verzió: v26.5 · Ez a kézikönyv a szervezőknek, a csapattagoknak (menedzser, értékesítő, kapus, jegykiküldő, promóter) és a platform üzemeltetőjének (SuperAdmin) szól. Minden funkciót leír: mire való, hol találod, hogyan állítod be, és mire figyelj.

Tipp: az admin felület minden oldalán a jobb felső ? gomb az adott oldal rövid súgóját nyitja meg. Ez a kézikönyv a teljes leírás.

1. Alapfogalmak

• Szervezet — a te céged / rendezvényszervező fiókod. Egy szervezetnek több eseménye és több csapattagja lehet.
• Esemény — egy rendezvény (koncert, buli, fesztivál, előadás). Lehet egyszeri, többalkalmas vagy állandó program.
• Jegytípus — egy eseményen belül megvásárolható jegyfajta (pl. Early Bird, Normál, VIP), saját árral, darabszámmal, szabályokkal.
• Rendelés — egy vásárlás. Egy rendelésben több jegy, kiegészítő (extra) és asztalfoglalás is lehet.
• Jegy — egy belépésre jogosító tétel, egyedi QR-kóddal. A QR-kód az első beolvasáskor érvényesül.
• Kezelési költség — a jegy árára rakódó, a vásárló által fizetett díj (jegytípusonként állítod). ÁFÁ-ja mindig a jegy ÁFA-kulcsával egyezik. Jegytípusonként be is építheted a jegyárba (5. fejezet).
• Platform díj — a TicketMagic díja jegyenként: online és ülőhelyes jegynél 1,9% + 69 Ft (2 000 Ft-os jegyárig csak 1,9%, fix díj nélkül), helyszíni kasszánál 0,9% + 29 Ft, ingyenes jegynél 0 Ft. A díj ÁFA-mentes (alanyi adómentesség). Részletek: 32. fejezet.
• Beléptető app — a /belepteto címen elérhető, telefonra telepíthető alkalmazás a bejárathoz, a pulthoz és a helyszíni kasszához. Net nélkül is működik.

Szerepkörök

2. Első lépések szervezőként

1. Regisztráció: ticketmagic.hu/szervezoknek/regisztracio — név, email, jelszó, szervezet neve. Ezzel létrejön a szervezeted, és te leszel a tulajdonosa.
2. Email megerősítés: a kapott levélben kattints a megerősítő linkre. Amíg nincs megerősítve, eseményt nem tudsz élesíteni (a vezérlőpulton újraküldheted a levelet).
3. Beállítások kitöltése (Admin → Beállítások) — lásd a 3. fejezetet. Élesítéshez (esemény publikálásához) kötelező:
   • a szervezet alapadatai (név, kapcsolattartó e-mail, nyilvános e-mail cím a vásárlóknak) és cégadatai (székhely / cím, adószám — ezek kerülnek a vásárlók számláira eladóként),
   • legalább egy fizetési mód (Stripe kártyás fizetés és/vagy banki átutalás adatai),
   • egy számlázó szolgáltatás (Billingo, Számlázz.hu vagy bizonylat.hu) kitöltve,
   • megerősített email cím.
4. Első esemény létrehozása (Admin → Események → Új esemény), jegytípusok felvétele, majd Publikált státusz.
5. Csapat meghívása (Admin → Csapattagok) — pl. kapusok a beléptetéshez.
6. Javasolt: kétlépcsős belépés bekapcsolása (bal alul a pajzs ikon).

Az Áttekintés oldal számai alapból csak a nyitott (még le nem zajlott, nem elmaradt) eseményekre vonatkoznak; a „Múltbeliekkel együtt” kapcsolóval minden eddigi esemény beleszámít. A teendőlista mindig mutatja, mi hiányzik még (pl. Stripe adatpótlás, hiányzó számla, megerősítés).

Az admin felépítése és a megjelenés

• Bal felső sarok — aktív szervezet: a jegy alakú címke mutatja, melyik szervezetben dolgozol (monogram, név, szerepköröd). Minden, amit létrehozol (esemény, jegytípus, kupon, meghívó, csapattag stb.), ebbe a szervezetbe kerül. Ugyanez a név a jobb felső sarokban is látszik minden oldalon; bármelyikre kattintva szervezetet válthatsz vagy újat hozhatsz létre (lásd a 30. fejezetet).
• Menü: csoportosítva — Események, Értékesítés, Marketing, Pénzügy, Szervezet, alul a Kézikönyv (és SuperAdminnak a platform menüpontjai).
• Megjelenés: bal alul a Megjelenés kapcsolóval választhatsz világos, sötét vagy rendszer szerinti témát (ez utóbbi a telefon / számítógép beállítását követi, este automatikusan sötét). A választást a böngésző megjegyzi, és a vásárlói oldalon is érvényes; ott a fejlécben a hold / nap ikonnal váltható.
• Bal alul: a neved mellett a pajzs ikon a kétlépcsős belépés, a személy ikon a profilod, a kilépés ikon a kijelentkezés.

SuperAdmin: a szervezetváltóban csak a saját szervezeteid vannak, belépéskor mindig a sajátodban indulsz. Más szervező fiókjába a SuperAdmin › Szervezetek listában a „Belépés kezelésre” gombbal léphetsz; amíg ott vagy, sárga sáv jelzi, és egy gombbal visszaléphetsz.

3. Beállítások (Admin → Beállítások)

Brandnév (Brand / Gyűjtőoldal, nem kötelező, de javasolt): ha megadod, a TicketMagic oldalain — eseményoldal, gyűjtőoldal, „Kövesd” doboz, követői és vásárlói levelek, jegy PDF — ez jelenik meg a cégnév helyett. A számlán, a fizetési szolgáltatónál (Stripe, SimplePay, Barion, Viva) és a jogi szövegekben mindig a hivatalos cégnév szerepel.

3.1 Cég- és kapcsolati adatok, publikus oldalcím

Nyilvános elérhetőség a vásárlóknak: e-mail cím (kötelező) és telefonszám (opcionális). Ez látszik a szervezői oldaladon, az eseményoldalakon („Kérdésed van? Írj a szervezőnek”), a rendelés oldalán és a vásárlói e-mailek láblécében — ide fordulhat a vásárló, ha gondja van. A belső kapcsolattartó e-mail / telefon ettől külön marad. Publikus oldalcím: a szervezői oldalad címe (ticketmagic.hu/szervezo/<cím>) a Beállításokban módosítható, ha a cím szabad — gépelés közben látod, hogy szabad-e. A régi cím automatikusan átirányít az újra (a régi linkek, QR-kódok, hirdetések tovább működnek), és más szervező nem veheti el. Rendszercímek (pl. admin, esemeny) nem választhatók.

Email, telefon, weboldal, székhely, adószám, cégjegyzékszám. Ezek jelennek meg a vásárlóknak kiállított számlákon (eladóként), a jegy PDF szelvényén és az emailekben (kapcsolat). Az ÁSZF és adatvédelmi link a vásárlói oldalon jelenik meg.

3.2 Stripe — kártyás fizetés

• Csatlakoztatás: „Stripe csatlakoztatása” gomb → a Stripe saját felületén megadod a cég- és bankadatokat. Előtöltés: a TicketMagic a Beállításokban már megadott adatokat átadja a Stripe-nak (cégnév, cégforma, adószám, cégjegyzékszám, székhely, e-mail, telefon, weboldal, ügyfélszolgálati e-mail/telefon, a bankszámlaszám IBAN-ra alakítva, valamint a Képviselő / tulajdonos kártyáról a képviselő neve, születési dátuma, e-mailje, telefonja, lakcíme, beosztása és tulajdoni hányada), így ezeket nem kell újra beírnod. Cégjegyzékszám nélkül a fiók egyéni vállalkozóként jön létre, a képviselő adataival. A Stripe-nál már megadott/ellenőrzött adatot nem írjuk felül. A személyazonosító okmányt a Stripe mindig maga kéri be.
• Vállalkozási forma (Beállítások → Cégadatok, kötelező): egyéni vállalkozó / egyéni cég / adószámos magánszemély, gazdasági társaság (Kft., Bt., Zrt. …) vagy nonprofit szervezet. Ez alapján adjuk át az adatokat a Stripe-nak: egyéni vállalkozónál magánszemélyként (a képviselő adataival, a bankszámla az ő nevén), cégnél cégként (cégnév, adószám, cégjegyzékszám, székhely, képviselő), nonprofitnál nonprofitként. Egyéni vállalkozónál és nonprofitnál azonosító számot nem küldünk — azt a Stripe a saját, a formának megfelelő mezőiben kéri. A bankszámlaszám kötelező (magyar formátum vagy IBAN), a Stripe-nak IBAN-ként adjuk át. A Stripe-csatlakozás új böngészőlapon nyílik, a TicketMagic lap nyitva marad.
• Képviselő / tulajdonos (Beállítások): a cég ügyvezetője, egyéni vállalkozónál te magad — minden mező kötelező (tulajdonrész nélkül 0%). Nem nyilvános adat, csak a Stripe-előtöltéshez használjuk. A cégadatok (e-mail, telefon, székhely, adószám, cégjegyzékszám / nyilvántartási szám) szintén kötelezők; amíg bármelyik hiányzik, új esemény nem tehető közzé (a már futó értékesítés nem áll le).
• Ha a Stripe csatlakoztatás nem indul: a hibaüzenet a Stripe pontos válaszát mutatja (pl. hibás weboldal-cím, vagy a platform Stripe-fiókjában még nincs engedélyezve a Connect), és a Naplóba is bekerül. A vásárlók pénze közvetlenül a te Stripe fiókodba érkezik; a platform díjat a Stripe a fizetéskor automatikusan levonja.
• Saját Stripe-fiók: a csatlakozással saját (standard) Stripe-fiókod jön létre; a dashboard.stripe.com oldalon kezeled (bankszámla, kifizetések, dokumentumok), a kifizetést a Stripe automatikusan ütemezi, a csalás miatti veszteséget a Stripe viseli.
• Állapot: a Beállításokban és a felső sávban látod, ha a Stripe adatpótlást kér (határidővel). Zöld = minden rendben; sárga = folyamatban/ellenőrzés; piros = korlátozva (pl. hiányzó dokumentum). A „Részletek és pótlás” gomb közvetlenül a Stripe hiányzó adataihoz visz. Változáskor emailt is kapsz.
• Kifizetés: a pénz a saját Stripe-fiókodba érkezik, és a Stripe automatikusan, naponta utalja a bankszámládra (a Stripe szokásos néhány napos feldolgozási idejével) — nincs visszatartás az esemény végéig. A Kifizetéseim oldalon látod az egyenleget, az utalásokat és eseményenként az elszámolást. Ha egy rendelést visszatérítesz, az a Stripe-egyenlegedből megy vissza.

3.2b SimplePay, Barion, Viva Payments

A Stripe mellett (vagy helyett) a saját SimplePay-, Barion- vagy Viva Payments-fiókodat is bekötheted — beállítás és lépésenkénti segédlet: 40. fejezet.

3.3 Banki átutalás

Bank neve, számlaszám, SWIFT/IBAN — csak akkor kell, ha átutalással is fizethetnek nálad. (A kártyás bevétel kifizetéséhez a bankszámládat a Stripe, illetve a SimplePay / Barion / Viva Payments a saját felületén kéri be.) Ha kitöltöd, a vásárló választhat átutalást: a rendelés „függőben” marad, a fizetési adatokat emailben kapja, és a jegyek akkor aktiválódnak, amikor a rendelést az adminban fizetettnek jelölöd. Az átutalt pénz közvetlenül hozzád érkezik; az ilyen rendelések platform díját a havi utalandó platform számla tartalmazza.

3.4 Számlázás (Billingo / Számlázz.hu / bizonylat.hu)

• Válaszd ki a szolgáltatót, add meg az API kulcsot (Billingo: API kulcs + számlatömb azonosító; Számlázz.hu: Agent kulcs; bizonylat.hu: bz_live_… API kulcs a bizonylat.hu API menüjéből), opcionálisan számla előtagot (bizonylat.hu-nál ez adja a számlatömböt, pl. TM → TM-2026-000001).
• Minden fizetett rendelésről automatikusan számla készül — bármelyik fizetési móddal (Stripe, SimplePay, Barion, Viva Payments, átutalás) fizettek: a számla a fizetés visszaigazolásakor indul, a fizetési mód a számlán is megjelenik. A vásárló emailben megkapja.
• bizonylat.hu teszteléshez: a bizonylat.hu-ban hozz létre „Tesztcég (NAV tesztkörnyezet)” céget, és annak API kulcsát add meg — a számlák „TESZT” jelöléssel, a NAV tesztrendszerébe mennek. A bizonylat.hu havi API-számlakeretének elfogyásakor a rendszer jelzi a hibát, és később újrapróbálja. A számlán tételesen szerepel minden jegy, a kezelési költség, az extrák és az asztal-előleg.
• Ha a kiállítás nem sikerül (pl. hibás kulcs), a rendelésnél megjelenik a hiba, a rendszer 15 percenként újrapróbálja, és a Rendelések listában a „Számla hiányzik” szűrővel megtalálod őket; egyenként is újraindíthatod.
• 0 Ft-os rendelésről és a helyszíni kassza eladásairól nem készül számla.
• Kinek értékesítesz? Magánszemélynek és cégnek is (a vásárló a pénztárban kérhet adószámos számlát: „Cégként / vállalkozóként vásárolok”), vagy csak magánszemélynek (pl. KATA): ilyenkor a pénztárban nincs céges opció, és a rendszer adószámos számlát akkor sem állít ki, ha valaki megpróbálná kijátszani. Eseményenként felülírható (Esemény → Pénztár).

3.5 Arculat és saját oldal-design

Márkaszín, rövid bemutatkozás, logó és fejléckép (a szervezői oldaladon jelennek meg: ticketmagic.hu/szervezo/<azonosító>). A márkaszín és a logó megjelenik az emailekben, a jegy PDF-en és a Wallet jegyen is.

Saját design — a szervezői oldaladon, az eseményoldalaidon, a sorozat- és a pénztároldalon:

• Kiemelő szín (gombok, kiemelések; a gomb szövegszíne automatikusan igazodik), háttérszín, háttérkép (feltöltés; halványítva, hogy a szöveg olvasható maradjon).
• Téma: a látogató beállítása szerint, mindig világos vagy mindig sötét. Ha háttérszínt adsz meg, a téma magától igazodik hozzá (sötét háttéren sötét).
• Címsorok betűtípusa (pl. Playfair Display, Bebas Neue, Space Grotesk) és a sarkok (szögletes / lekerekített).
• Eseményenként felülírható: Esemény szerkesztése → Saját design ennél az eseménynél (szín, háttérszín, háttérként az esemény borítóképe, téma).

3.5b Pénztár: fizetési módok, megjegyzések

• Melyik fizetési mód jelenjen meg / hogyan kapcsolok ki egyet (pl. a banki átutalást)? Beállítások → Pénztár: a bekötött szolgáltatók (Stripe, SimplePay, Barion, Viva Payments, átutalás) közül bejelölöd, melyiket kínálod fel — egyet vagy többet (ilyenkor a vásárló választ) —, és megadod a sorrendet (az első az alapértelmezett). Új szolgáltató bekötésekor az automatikusan a lista végére kerül.
• Eseményenként szűkíthető: Esemény szerkesztése → Pénztár ennél az eseménynél.
• Megjegyzés fizetési módonként (1 sor a mód alatt, pl. „Apple Pay és Google Pay is”), és megjegyzés a „Megrendelés” gomb fölött (eseményenként felülírható).
• Megjegyzés a jegyek alatt: a jegytípus Rövid leírás mezője a jegy alatt jelenik meg az eseményoldalon (a Részletes leírás lenyitható).
• Szervezőtársnál a vásárláskor aktív számlázó cég pénztár-beállításai érvényesek.

3.6 Követőkódok és hirdetésmérés

GA4, Google Tag Manager, Google Ads (konverziós azonosító + címke), Meta Pixel, TikTok Pixel, valamint Meta Conversions API token (és teszt eseménykód). A kódok a te szervezői oldaladon és az eseményeid oldalain futnak (eseményenként felülírhatók), a többi TicketMagic oldalon nem. Csak akkor töltődnek be, ha a látogató a süti-sávban hozzájárult. Részletek: 36. fejezet.

ÁFA-mentesség kódja: ha 0% ÁFÁ-val árulsz jegyet, válaszd ki az indokot (AAM — alanyi adómentes, TAM — tárgyi adómentes); ez kerül a számlára. Itt látod a rád vonatkozó platformdíjat is (csak olvasható).

3.7 Váróterem

Nagy érdeklődésű jegyeladásnál (pl. jegyek nyitása) bekapcsolható: egyszerre legfeljebb a megadott számú látogató lehet a vásárlásban, a többiek sorszámot kapnak és automatikusan beengedjük őket. Itt az alapértelmezést állítod; eseményenként is kapcsolható.

3.8 Jegyátadás és továbbeladás

• Jegyátadás (alapból bekapcsolva): a vásárló ingyen átadhatja a jegyét valaki másnak.
• Hivatalos továbbeladás (alapból kikapcsolva): a vásárló eladásra kínálhatja a jegyét az eseményoldalon, legfeljebb az eredeti ár +10%-áért.
• Mikor lehet átadni / továbbadni? Bármikor; ha a megvásárolt jegytípus már nem kapható (elfogyott, lezárult az értékesítése vagy kikapcsoltad); ha az eseményre már semmilyen jegy nem kapható. Amíg a feltétel nem teljesül, a vásárló a rendelése oldalán látja, mikortól adhatja át.
• Ez a szervezeti alapbeállítás; eseményenként felülírható (Engedélyezve / Tiltva / Szervezeti beállítás szerint). Részletek: 18. fejezet.

3.9 Biztonság

Kétlépcsős belépés kötelező a csapatnak — bekapcsolva minden csapattagnak be kell állítania a 2FA-t, addig más oldalt nem ér el. Részletek: 22. fejezet.

4. Események

4.1 Új esemény

Admin → Események → Új esemény. Gyors indulás: „Indulj sablonból” — mentett sablonnál a beállításokat, a borítóképet és a jegytípusokat is átveszi; korábbi eseménynél csak a beállításokat. Csak a nevet és a dátumot kell megadnod.

Eseménysablon: egy meglévő esemény oldalán a jobb oldali „Mentés sablonként” dobozban adj nevet a sablonnak és mentsd. Azonos nevű sablon felülíródik. Sablont az Új esemény oldalon, kiválasztás után törölhetsz.

Fülek: az eseményszerkesztő fülekre bontva: Alapadatok · Jegytípusok · Jegy-beállítások · Láthatóság és e-mail · SEO és követés · Eszközök. Az Eszközök fülön témák szerint (értékesítés, helyek, vendégek, kommunikáció, adminisztráció) érhetők el a további funkciók: időzített árak, ülőhelyek, vendéglisták, levelek, szervezőtársak, elmaradás stb. A Mentés gomb bármelyik fülön az összes fül adatait menti. Az új jegytípus űrlapja is lépésekre bontva: Ár és darabszám → Értékesítés → Belépés → Leírás és kép — a Mentés bármelyik lépésből működik.

Kezelési költség: négy mód közül választhatsz. A Javasolt az alapértelmezett: a platformdíjadat és a becsült kártyás díjat fedezi, a következő 10 Ft-ra kerekítve (pl. 68 → 70 Ft), így a jegyárból semmi nem vész el. A többi: Fix Ft, a jegyár %-a, vagy Fix + %.

Jegyek sorrendje és szakaszai: a Jegytípusok fülön a jegyeket a ⠿ jelnél fogva húzhatod, vagy a ▲▼ nyilakkal mozgathatod. A „+ Szakasz” gombbal fejléceket adhatsz hozzá (pl. Belépőjegyek, Bérletek, VIP jegyek). Egy jegy a fölötte lévő szakaszba tartozik, a vásárlók is így, csoportosítva látják.

Borítókép: a „Kép kiválasztása” után azonnal feltöltődik és mentődik, külön gomb nélkül. Cserélni ugyanígy, eltávolítani a „Törlés” gombbal lehet.

Alapadatok

• Név (magyarul kötelező, angolul ajánlott), leírás magyarul és angolul — az angol nyelvű látogatók az angol szöveget látják (ha üres, a magyart).
• Kategória — a főoldali szűréshez.
• Időpont típusa:
  • Egyszeri — kezdés és (opcionális) befejezés.
  • Többalkalmas — több időpont, mindegyik saját címkével (pl. „1. nap”). Az időpontokat az esemény oldalán, az „Időpontok” dobozban kezeled.
  • Állandó program — szöveges leírás (pl. „Minden pénteken 20:00-tól”).
• Helyszín: név, kapacitás, irányítószám, város, utca. A cím alapján térkép jelenik meg az eseményoldalon.
• Státusz: Vázlat (nem látszik) / Publikált (látszik, vásárolható). Publikáláskor a rendszer ellenőrzi, hogy a szervezet készen áll-e (fizetési mód, számlázó, megerősített email) — ha nem, vázlatban marad, és megmutatja, mi hiányzik.
• Láthatóság: Nyilvános (listázva a főoldalon) vagy Nem listázott (csak közvetlen linkkel érhető el).
• Borítókép — Facebook-eseményborító arány (1,91:1, pl. 1920×1005 vagy 1200×628 px); a Facebook-eseményed borítóképe változtatás nélkül jó. Ez jelenik meg az eseményoldal tetején teljes szélességben, az eseménylistában a kártyán, és a jegy PDF-en is (ha a jegytípusnak nincs saját képe). Más arányú képet a rendszer a közepéből vág.

SEO és követőkódok — meta leírás (Google találati szöveg), eseményre szóló egyedi GA4/GTM/Pixel kódok (ha ki van kapcsolva a „szervezet követőkódjainak használata”).

Jegy-beállítások (jelölőnégyzetek)

• Jegy névmódosítás — a vásárló a fiókjában módosíthatja a jegyen szereplő nevet.
• Helyszín kapacitás (beléptető riasztáshoz) — 90%-nál és 100%-nál a beléptető app figyelmeztet.
• Telefonszám bekérése és Születési év bekérése a pénztárnál (korhatáros jegynél a születési év automatikusan kötelező).
• Előregisztráció — amíg nincs megvásárolható jegy, a látogatók feliratkozhatnak; indulásnál automatikusan értesítjük őket (lásd 15. fejezet).
• Asztalfoglalás interaktív térképpel (8. fejezet).
• Számozott ülőhelyek (9. fejezet).
• Helyszíni jegyeladás a beléptető app Kassza fülén (20. fejezet).
• „Ki megy még?” — az eseményoldalon megjelenik, hány jegy kelt el, és azoknak a vásárlóknak a keresztneve, akik ehhez a pénztárnál hozzájárultak.
• Jegyátadás és Továbbeladás — eseményszintű felülírás (Szervezeti szerint / Engedélyezve / Tiltva).

Láthatóság és szabályzat — eseményszabályzat linkje (ha megadod, a vásárlónak a pénztárnál el kell fogadnia), esemény-specifikus adatkezelési tájékoztató linkje.

Visszaigazoló email személyre szabása — saját üzenet a visszaigazoló levélbe és a jegy PDF „Fontos tudnivalók” részébe (pl. kapunyitás, parkolás, dress code), magyarul és angolul.

4.2 Az esemény oldala az adminban

Mentés után a jobb oldali dobozokban: publikus link (másolható), Időpontok (többalkalmasnál), Esemény csapat, Statisztika, és gyorslinkek: kiegészítők, vendéglisták, asztalok, ülőhelyek, kasszajelentés, jegyátadások, eladási cél, előregisztráltak, beléptetési napló, fellépők, időzített árak és csoportos kedvezmények, levelek a vásárlóknak, külső eladások importja.

• Fellépők — név, műfaj, fellépés időpontja, sorrend, rövid bemutatkozás; az eseményoldalon jelennek meg.
• Statisztika — napi eladás és megtekintés (30 nap), jegytípusok kihasználtsága.
• Beágyazás — ticketmagic.hu/embed/<esemény-azonosító> egy weboldalba illeszthető jegyvásárló doboz.

5. Jegytípusok

Az esemény szerkesztő oldalán: + Új jegytípus. Egy meglévőt a gombbal szerkesztesz.

Időzített árak (Esemény → Időzített árak és csoportos kedvezmények)

Egy jegytípusnak egy időszakra más árat adhatsz — olcsóbbat (early bird) vagy drágábbat (pl. az utolsó héten). Akárhány időszakot felvehetsz, és bármelyiket utólag szerkesztheted vagy törölheted (kattints a sorra). Időszakon kívül mindig a jegytípus alapára érvényes. Ha két időszak átfed, a vásárlónak kedvezőbb (alacsonyabb) ár számít. Az eseményoldalon az alapár csak akkor jelenik meg áthúzva, ha az időzített ár alacsonyabb.

Csoportos kedvezmények

Ugyanezen az oldalon. Kód nélkül, automatikusan érvényesül a kosárban, egy jegytípusra vagy az esemény minden jegyére:

• Százalékos: pl. 4 jegytől −10%.
• Ajándék jegy: pl. „4-et fizet, 5-öt kap”. A számlán a 4 fizetett jegy szerepel teljes áron, az 5. jegy külön, 0 Ft-os tételként; a vásárló mind az 5 jegyet (PDF, Wallet) megkapja. Az ajándék jegy után platformdíj nincs.

Ha több szabály is érvényes, a vásárlónak legkedvezőbb számít. A kosárban és az eseményoldalon a vásárló látja az ajánlatot („4 jegy áráért 5”). Szabályt ki-be kapcsolhatsz és törölhetsz.

6. Sorozatok és bérletek (Admin → Sorozatok és bérletek)

Egy sorozat összefogja az összetartozó eseményeket (pl. klubest-sorozat). A sorozatnak saját nyilvános oldala van (/sorozat/<azonosító>), az eseményoldalakon pedig „A sorozat része” sáv jelenik meg.

Bérlet: a sorozaton belül létrehozott jegytípus, ami a sorozat minden alkalmára érvényes (alkalmanként egyszer léptet be). Mezők: név, ár, kezelési költség, darabszám, max./rendelés, ÁFA, melyik esemény oldalán vásárolható (a többi alkalom oldalán is megjelenik), leírás. „Beállítás minden alkalomra” — egy kattintással minden eseményhez rendeled a sorozatot.

7. Kiegészítők / extrák (Admin → Kiegészítők)

Italcsomag, parkolás, ruhatár, merch — bármi, amit a jegy mellé el lehet adni.

• Mezők: név, ár, ÁFA, rövid leírás, készlet, max./rendelés, beváltható eddig (pl. 23:00 — korai érkezésre ösztönöz), sorrend.
• A vásárló az eseményoldalon, a kosárban, illetve utólag is megveheti (a visszaigazoló levélben és a rendelés oldalán „Extrák vásárlása” link — upsell).
• Beváltás: a pultnál a beléptető app Pult fülén a vendég jegyének QR-kódját olvasod be, és „Kiad 1” gombbal adod ki (offline is). A jegy PDF-en is szerepelnek a még be nem váltott extrák.

8. Asztalfoglalás

Esemény → Asztalfoglalás (az esemény beállításaiban be kell kapcsolni).

• Alaprajz: az asztalokat egérrel húzod a helyükre a térképen; feltölthetsz alaprajz-képet.
• Új asztal(ok): név/szám, zóna, férőhely, forma (kerek/szögletes), online előleg (a vásárló ezt fizeti, a fogyasztásba beszámít), minimum fogyasztás, darab (sorszámozva egyszerre több).
• Kézi foglalás: telefonos / törzsvendég foglalás rögzítése szabad asztalra.
• A vásárló az eseményoldalon kiválasztja az asztalt, megadja a létszámot, és az előleggel együtt fizet. A foglalás a fizetés idejére tartva van.
• Érkezés: a beléptető Lista fülén névre / asztalra keresve „Megérkeztek” gomb.

9. Számozott ülőhelyek

Színházi előadáshoz, gálaesthez. Esemény → Számozott ülőhelyek (az eseményben a „Számozott ülőhelyek” jelölőnégyzettel kapcsolod be — az első generálás automatikusan bekapcsolja).

Generálás (jobb oldali űrlap)

• Szektor neve (pl. Földszint, Erkély bal) — nem kötelező.
• Sorok: A-J, 1-15 vagy felsorolás: A,B,C.
• Első és utolsó szék száma soronként.
• Árkategória — melyik jegytípushoz tartoznak a székek (az ára érvényes).
• Vízszintes / függőleges eltolás — a blokk helye a térképen (üresen a következő blokk automatikusan az előző alá kerül).
• Folyosó / x szék — pl. 6 → minden 6. szék után folyosó.
• Számozás jobbról balra.

Szerkesztés: kattints székekre (vagy a sor betűjére az egész sorhoz), majd: Letilt (nem eladható, pl. technikai hely), Eladhatóvá tesz, Árkategória (átsorolás másik jegytípusba), Töröl (eladott szék nem törölhető). Az árkategóriák színét a színválasztóval állítod.

Vásárló: az eseményoldalon a nézőtér-térképen koppintással választ, a kiválasztott helyeket 15 percig foglaljuk neki, a pénztárnál a fizetés idejére meghosszabbítjuk. Ülőhelyes jegytípus csak a térképen keresztül vehető. A hely szerepel a jegy PDF-en, a Wallet jegyen és a beléptetőben. Lejárt / törölt / visszatérített rendelésnél a hely automatikusan újra eladható.

Figyelj: a jegytípus „darabszáma” ne legyen kevesebb a székek számánál. A helyszíni kasszában nem lehet széket kiosztani.

10. Vendéglisták (Admin → Vendéglisták)

• Új lista: esemény, név, promóter (ha az övé), belépés típusa (Ingyenes vagy Kedvezményes — ekkor a kapunál fizetendő ár), max. létszám, max. kísérő vendégenként, lista zárása (utána nem lehet felírni), érvényes érkezés eddig (pl. 23:30 — utána normál jegy kell).
• Vendégek felvétele: egyenként vagy tömegesen (soronként egy név, opcionálisan email/telefon, kísérők száma).
• Önfeliratkozó link: megosztható link, amin a vendégek maguk iratkoznak fel (visszaigazoló emailt kapnak).
• Export: CSV.
• Beléptetés: a beléptető Lista fülén név, telefon vagy email szerint keresve, létszám választással („3 fő” stb.). Kedvezményes listánál az app kiírja, mennyit kell beszedni.

11. Promóterek és jutalékok (Admin → Promóterek, Jutalékok)

• Új promóter: név, egyedi kód (a link része: …/esemeny/xy?ref=KOD), email, telefon, jutalék típusa (% a jegy névértékéből vagy fix Ft / eladott jegy), jutalék értéke, csapatvezető (a vezető a csapata eladásaiból külön %-ot kap), belépési jelszó a promóter-panelhez.
• A linkre kattintó vásárló 30 napig a promóterhez kötődik; a fizetett rendelés után jutalék keletkezik.
• Jutalékok: szűrés promóterre / eseményre; Kijelöltek jóváhagyása, Elutasítás, Kijelöltek kifizetve. Visszatérített rendelés jutaléka automatikusan módosul.
• Promóter felület (/promoter, lásd 42. fejezet): eladásai eseményenként, jutalékai, csapata és saját vendéglistái.

12. Kuponok (Admin → Kuponok)

• Új kupon: esemény, kód, típus (fix Ft vagy %), érték, max. felhasználás (üres = korlátlan), érvényesség.
• Tömeges import: Excel (.xlsx) vagy CSV feltöltése — letölthető sablon a felületen.
• A kupon csak a jegyek árára vonatkozik (extrákra, asztal-előlegre nem); a pénztárnál azonnal ellenőrizzük.

13. Egyedi meghívók (Admin → Egyedi meghívók)

Rejtett jegytípushoz (pl. VIP, szponzori, presale) személyes linkeket küldhetsz.

• Esemény, rejtett jegytípus, címzettek email címei (soronként), max. felhasználás címzettenként, lejárat, egyedi üzenet.
• Minden címzett saját linket kap emailben; csak ezzel látja és veheti meg a rejtett jegyet. A felhasználás csak sikeres fizetésnél számít. A kiküldött meghívók listájában látod a felhasználást, és QR-kódot is letölthetsz hozzájuk.

14. Jegykiküldés (Admin → Jegykiküldés)

Tiszteletjegy, nyereményjegy, partnerjegy kiküldése: esemény, jegytípus, címzett neve és emailje, darabszám, megjegyzés (csak neked). A címzett a jegyeket PDF-ben kapja; 0 Ft-os rendelésként jelenik meg. A Jegykiküldő szerepkörű csapattag csak ezt az oldalt látja.

15. Várólista és előregisztráció

• Várólista: ha egy jegytípus elfogy, a vásárló megadhatja az email címét. Ha jegy szabadul fel (lejárt / törölt rendelés, visszatérítés), automatikus értesítést kap („Felszabadult jegy”).
• Előregisztráció: amíg nincs megvásárolható jegy, az eseményoldalon feliratkozó doboz jelenik meg. Amikor az első jegytípus értékesítése elindul, a rendszer automatikusan levelet küld („Indul a jegyértékesítés”). Lista: Esemény → Előregisztráltak (exportálható).

16. Egyedi kérdések (Admin → Egyedi kérdések)

A pénztárnál feltett saját kérdések (pl. pólóméret, étkezési igény). Kérdés szövege, hatókör (egy esemény / minden esemény / adott jegytípus), mezőtípus (szöveg, szám, dátum, legördülő lista, igen/nem), opciók, kötelező-e. A válaszok a rendelés adatai között és az exportban jelennek meg.

17. Email sablonok (Admin → Email sablonok)

Minden levél HTML formátumú, a szervezet logójával és márkaszínével; mellette egyszerű szöveges változat is megy. Minden sablon magyarul és angolul szerkeszthető; a vásárló a vásárláskori nyelvén kapja.

Szerkesztő: tárgy + szöveg. Formázás: # Cím, ## Alcím, félkövér, dőlt, link szövege, - felsorolás, --- elválasztó, [[Gomb felirata|url]] gomb, !kép. Változók (pl. {{buyer_name}}, {{event_name}}, {{pdf_url}}) a gombokkal szúrhatók be, küldéskor a valós adatra cserélődnek. Jobb oldalt élő előnézet, és tesztlevél küldhető saját magadnak. „Visszaállítás” gombbal az alapszöveg tér vissza.

Elhagyott kosár emlékeztető

• Bekapcsolás: a sablon tetején (alapból kikapcsolva).
• Küldés ennyi idő után: 30 perc – 1 nap.
• Kuponkód (nem kötelező): a levélben {{coupon_code}}-ként, és a kosár-visszaállításkor automatikusan alkalmazzuk. A kupont előbb a Kuponok menüben hozd létre.
• Működés: ha a vásárló a pénztárnál megadja az email címét, de nem fejezi be a vásárlást (és később sem vásárol), a beállított idő után egyszer kap egy levelet egy linkkel, ami visszaállítja a kosarát. Ugyanarra az eseményre 7 napon belül legfeljebb egy levél megy; a leiratkozottak nem kapnak. A pénztárnál a vásárló tájékoztatást lát erről.
• Statisztika (90 nap): mentett kosarak, kiküldött emlékeztetők, visszatértek, visszanyert bevétel.

18. Jegyátadás és hivatalos továbbeladás

A szervező beállítja

• Szervezeti alapértelmezés: Beállítások → Jegyátadás és továbbeladás.
• Eseményenként felülírható az esemény beállításainál.

Jegyátadás (ajándékozás)

1. A vásárló a rendelés oldalán (link a visszaigazoló levélben) a jegy mellett: Átadás → új tulajdonos neve + email.
2. A jegy új QR-kódot kap, a régi azonnal érvénytelen (a beléptető is elutasítja).
3. Az új tulajdonos emailben kapja a jegyet (PDF + saját rendelés-oldal), és ő is továbbadhatja.
4. Csak aktív, még fel nem használt jegy adható át, és csak az esemény kezdete előtt.
5. Az eredeti rendelés pénzügyileg változatlan; teljes visszatérítésekor az ebből átadott jegyek is érvénytelenné válnak.

Hivatalos továbbeladás

1. A vásárló a rendelés oldalán: Eladás → ár (legfeljebb az eredeti jegyár +10%-a), szükség esetén bankszámla és számlatulajdonos.
2. A jegy az eseményoldalon a „Hivatalos továbbeladás” dobozban jelenik meg. Amíg eladásra van kínálva, nem léptethető be (az eladó bármikor visszavonhatja).
3. A vevő a megszokott módon fizet: az eladási ár + a jegytípus kezelési költsége; a platform díj ugyanúgy levonódik. Csak kártyás fizetés (Stripe) lehetséges. A jegyet a fizetés idejére (30 perc) lefoglaljuk.
4. Fizetés után a jegy új QR-kóddal a vevő nevére kerül, a vevő megkapja a jegyet és a számlát; az eladó értesítést kap.
5. Az eladó pénze:
   • Ha az eredetileg kártyával fizetett: az eredeti jegyárig automatikusan visszatérítjük a kártyájára (a te Stripe egyenlegedből — a vevő fizetése fedezi). Az eredeti kezelési költség nem jár vissza.
   • A felárat (ha drágábban adta el), illetve ha eredetileg nem kártyával fizetett, a teljes árat neked kell utalnod az eladó megadott bankszámlájára.
6. Admin → Esemény → Jegyátadások és továbbeladás: az „Utalandó az eladóknak” lista (név, IBAN, közlemény, összeg) — utalás után Kifizetve. Ugyanitt a hirdetések állapota és a teljes átadási napló.

19. Rendelések (Admin → Rendelések)

• Szűrés: esemény, státusz, keresés (név, email, rendelésszám), „Számla hiányzik”.
• Státuszok: Függőben (kártyás fizetés folyamatban — 30 perc után automatikusan lejár és a készlet felszabadul; vagy átutalásra vár), Fizetve, Törölve, Visszatérítve.
• Rendelés részletei: vásárló adatai, tételek, jegyek QR-rel és állapottal, fizetési mód (online kártya / átutalás / helyszíni készpénz / helyszíni kártya / ingyenes), forrás (online / helyszíni kassza / továbbeladás / jegyátadás), számla, egyedi kérdések válaszai.
• Műveletek:
  • Fizetettnek jelölés (átutalásnál) → jegyek aktiválódnak, email + számla megy.
  • Visszatérítés teljes rendelésre vagy jegyenként — csak a tulajdonos és a menedzser indíthatja, kötelező indoklással (naplózva). A vásárló a teljes kifizetett összeget visszakapja (jegyár + kezelési költség; teljes rendelésnél a kiegészítők is). Online fizetésnél (Stripe, SimplePay, Barion, Viva Payments — ez utóbbinál a Merchant ID és az API Key is kell) a pénz automatikusan visszamegy; átutalásnál / helyszíni fizetésnél kézzel kell visszaadnod. A TicketMagic platformdíja nem jár vissza. A jegyek érvénytelenné válnak, a készlet és az ülőhely felszabadul, a várólistások értesülnek. Törlés visszatérítés nélkül: ha a pénzt máshogy rendezted.
  • Számla: visszatérítéskor / törléskor a kiállított számláról automatikusan sztornó (érvénytelenítő) számla készül a beállított számlázóval (Billingo, Számlázz.hu, bizonylat.hu), és a vásárló megkapja. Részleges (jegyenkénti) visszatérítésnél a régi számla sztornózása után új számla készül a megmaradt tételekről. Ha a számlázó épp hibát ad, a rendelésnél piros jelzés látszik, a rendszer automatikusan újrapróbálja (vagy „Sztornó kiállítása most”). A rendelésnél a számlák története is látszik.
  • Beléptetés visszavonása jegyenként vagy az egész rendelésre (pl. téves beolvasás).
  • PDF letöltése, visszaigazolás újraküldése, számla újrapróbálása.

• Elmaradt esemény — tömeges visszatérítés (Esemény szerkesztése → Az esemény elmarad): ok + üzenet a vásárlóknak + megerősítés (az esemény nevének beírása). Azonnal leáll a jegyeladás, az eseményoldalon „Az esemény elmarad” jelenik meg, a fizetetlen rendelések törlődnek, a fizetett rendelések visszatérítése a háttérben indul (percenként kb. 15), mindegyikről sztornó számla és e-mail a vásárlónak az üzeneteddel. Az oldalon látszik: sorban / visszatérítve / sikertelen (újrapróbálható), és a kézzel visszautalandó (átutalásos, helyszíni) rendelések listája.

20. Beléptető app (/belepteto)

20.1 Telepítés és bejelentkezés

• Nyisd meg telefonon: ticketmagic.hu/belepto → böngésző menü → Hozzáadás a kezdőképernyőhöz. Ettől kezdve alkalmazásként indul, net nélkül is.
• Bejelentkezés a csapattag email címével és jelszavával (tulajdonos, menedzser, kapus). Ha a fiókon kétlépcsős belépés van, a 6 jegyű kódot is kéri. A bejelentkezés 7 napig érvényes.
• Eseményválasztás: az aktuális (3 napnál nem régebbi) publikált események. Minden eseménynél látszik, van-e letöltött offline adat. Belépés után az app a háttérben minden eseményed adatait letölti.

20.2 Élő kapcsolat és automatikus offline mód

• A fejlécben a kapcsolatjelző: Élő · óó:pp:mm (utolsó szinkron ideje) vagy Offline · helyi adat. A sárga szám a még fel nem töltött műveletek száma.
• Amíg van net: a beolvasásokat a szerver dönti el (így két kapu sem engedheti be ugyanazt a jegyet), az app 5 másodpercenként ellenőrzi a kapcsolatot, és folyamatosan szinkronizál: 10 másodpercenként (és minden változáskor azonnal) letölti a többi eszköz beléptetéseit, az új online vásárlásokat, a vendéglista- és asztalváltozásokat.
• Ha elmegy a net: az app magától offline módra vált (értesítést is mutat), és a letöltött adatokból, ugyanazokkal a szabályokkal enged be: fizetettség, törölt/átadott jegy, más esemény, időablak, bérlet, késési felár, már beléptetett. Minden művelet a telefonon tárolódik (újraindítás, lemerülés után is megmarad).
• Amikor visszajön a net: az app automatikusan feltölti az offline beléptetéseket, eladásokat, kiadott extrákat, majd letölti a közben történt változásokat, és visszaáll élő módra („Szinkronizálva — élő kapcsolat helyreállt”).
• Ütközés: ha két eszköz offline ugyanazt a jegyet engedte be, szinkronkor ütközésként jelenik meg (az appban és a kasszajelentésben).
• Kényszerített offline mód (Kapcsolat lap): akadozó wifinél bekapcsolható, ekkor mindig a helyi adatokból dönt (gyors), a háttérszinkron ilyenkor is fut.
• Kapcsolat és adatok lap (a kapcsolatjelzőre koppintva): letöltött adatok, szinkronra váró műveletek, utolsó szinkron, Adatok frissítése, Szinkron most, statisztika (bent / összes / még kint, vendéglista, kapacitás), szinkron eltérések, kijelentkezés.

20.3 Beléptetés fül

• Kamerás QR olvasás (vaku kapcsoló), kézi bevitel, vagy Bluetooth/USB vonalkódolvasó (külön beállítás nélkül).
• Eredmények: Belépés engedélyezve (jegytípus, név, ülőhely, az extrák a pultnál) · Már beváltották (mikor) · Érvénytelen (ismeretlen kód, nem fizetett, törölt, más esemény, nem beolvasható, időablakon kívül, továbbeladásra kínált) · Késői érkezés — felár: a felárat beszeded, majd Készpénz vagy Kártya gombbal rögzíted, és a vendég belép.
• Bérlet: a sorozat minden alkalmán egyszer lép be.
• Kapacitás riasztás: 90%-nál és 100%-nál piros sáv és rezgés.
• Hang és rezgés jelzi az eredményt.

20.4 Pult fül

A vendég jegyét beolvasva megjelennek a hozzá tartozó extrák (italcsomag stb.) a még kiadható mennyiséggel és határidővel; Kiad 1 gombbal adod ki. Offline is működik.

20.5 Lista fül

Keresés névre, telefonra, emailre, asztalra. Vendéglistás vendégnél a belépő létszámot választod; kedvezményes listánál kiírja a beszedendő összeget. Asztalnál Megérkeztek. Offline is működik. Visszavonni csak az adminban lehet.

20.6 Kassza fül — helyszíni jegyeladás

• A helyszínen eladható jegytípusok a kapus árral és a maradék kerettel.
• + / − darabszám → Fizetendő → Készpénz (a kapott összeg beírásával a visszajárót is kiszámolja) vagy Kártya (a saját POS terminálodon fizetnek, az app csak rögzíti, ha sikeres volt).
• Belépés most (alapból bekapcsolva): a jegyek azonnal beléptetve. Kikapcsolva az app QR-kódokat mutat, amiket a vendég lefotóz (pl. barátnak vesz jegyet).
• Vevő adatai (nem kötelező): név és email — email megadásakor a PDF jegyek is kimennek.
• Offline is lehet eladni — a QR-kódokat az eszköz állítja elő, szinkronkor a szerver ugyanazokkal hozza létre a jegyeket.
• Műszakom: ezen az eszközön eladott készpénz / kártya összesen; online a szerver szerinti összesítő is (saját és a teljes esemény).

20.7 Admin: beléptetési napló

Esemény → Beléptetési napló: minden beolvasás (sikeres, már beváltott, érvénytelen), ki és mikor léptette be; innen a beléptetés vissza is vonható.

20.8 Mobilappba ágyazás (fejlesztőknek)

A beléptető WebView-ba ágyazható (?api=…, ?scanner=native), JavaScript híd (window.TM.scan(kód), setOffline, sync, state), eseményküldés a natív app felé, REST API Bearer tokennel. Leírás: docs/BELEPTETO_API.md.

20.9 TicketMagic Gate app és adatvédelem (v42)

• A TicketMagic Gate app (iPhone, iPad, Android) a beléptetőt a telefonra telepítve tartalmazza: net nélkül is elindul, és magától vált online és offline mód között.
• A letöltött jegylista védett: a QR-kódok helyett csak azok lenyomata kerül a készülékre, a vendég neve rövidítve (pl. „Kovács Ö.”), rendelésszám, e-mail és telefonszám nélkül. Minden helyi adat titkosítva van, a kulcsot a kapus sem tudja kiolvasni.
• A helyi adatok törlődnek kijelentkezéskor, ha a szervező kilépteti az eszközt, és az esemény után 48 órával.
• Megjelenés: ugyanazok a betűk és színek, mint a TicketMagic többi részén; a telefon világos / sötét beállítását követi, az eseményválasztó alján kézzel is átállítható.
• Eredmény: teljes képernyős zöld (beléphet), sárga (már bent / felár), piros (érvénytelen) villanás, rezgéssel és hanggal.

20.9.1 Ki mit használhat a beléptetőben

• A Csapat oldalon minden beléptetőnél bejelölhető, mit lát: Beléptetés, Pult, Lista, Kassza. Beléptető szerepkörű tagnál a táblázatban, beléptető jogosultságnál a jogosultság sorában (megadáskor is).
• Alapértelmezés: Beléptetés + Lista. A pénzkezeléshez (Kassza) és a pulthoz külön jogot kell adni. Tulajdonos és menedzser mindent lát.
• A kapus csak a megengedett füleket látja; a tiltott műveletet a szerver offline szinkronnál is elutasítja.

20.10 Kapuk élőben és műszakjelentés (Esemény → Eszközök)

• Kapuk élőben: bent lévők, belépési ütem (fő/perc), utolsó 15 perc / óra, percenkénti grafikon, kapunként (eszközönként) az állapot (online / offline), az akkumulátor, a szinkronra váró műveletek és a legutóbbi elutasítások. 10 másodpercenként frissül.
• Műszakjelentés kapusonként: első és utolsó beolvasás, beengedett (ebből offline), már bent volt, érvénytelen, elutasítási arány, fő/óra, visszavont belépések. CSV-ben letölthető.
• Beléptető eszközök (Admin): a bejelentkezett telefonok listája; elveszett telefont itt lehet kiléptetni — a következő netkapcsolatkor az app törli róla az adatokat.

20.11 Viszonteladás: TicketSwap SecureSwap

• A jegyek továbbadása kizárólag a TicketSwapon történik (a TicketMagicben nincs saját eladás vagy ajándékozás). A vásárló a TicketSwapon tölti fel a jegyét; eladáskor a régi kód érvénytelen lesz, a vevő új, a saját nevére szóló jegyet kap. Pénzt a TicketMagic nem kezel.
• Minden eseményre vonatkozik. 0 Ft-ért szerzett jegy (pl. ingyenes tiszteletjegy, 100%-os kupon) nem adható el; a pénzért vett jegy igen, típustól függetlenül.
• Késleltetés: Esemény → Jegy-beállítások → „A TicketSwapon ettől adható tovább”; jegytípusonként felülírható (Eladás lépés). Üresen: azonnal továbbadható. A vásárló a rendelés oldalán és a visszaigazoló e-mailben látja a dátumot.
• Az esemény kezdete után 1 órával már nem lehet cserélni.
• Amíg a jegy a TicketSwapon eladásra van kínálva, a QR-kódja nem látszik (rendelés oldal, PDF, Wallet), nem téríthető vissza, és a kapu elutasítja. Ha a hirdetést visszavonják, minden visszaáll; az esemény vége után a zárolás magától feloldódik.
• A kapu a továbbadott jegy régi kódjára ezt írja: „Ezt a jegyet továbbadták a TicketSwapon”.
• Üzemeltetőnek: SuperAdmin → TicketSwap (kapcsolati adatok, token, tesztkészlet, zárolt jegyek kézi feloldása, napló).

21. Kasszajelentés (Esemény → Kasszajelentés)

• Készpénz a kasszában (eladás + készpénzes felár), Kártyás (terminál), Összesen, helyszíni jegyek és eladások száma.
• Kapusonként (első–utolsó eladás ideje) — kattintva csak az adott kapus adatai (műszak-elszámolás).
• Jegytípusonként fizetési mód szerint, késői érkezés felárak, vendéglista kedvezményes belépők (tájékoztató).
• Offline szinkron eltérések (ütközések, elutasított műveletek).
• Eladások listája a rendelésekre mutató linkkel.
• Nyomtatható változat aláírási hellyel (átadó / átvevő) és CSV export.
• A helyszíni eladás platform díja a havi utalandó platform számlán jelenik meg. Nyugtát / számlát a helyszíni pénztárgép ad.

22. Biztonság

Kétlépcsős belépés (2FA)

• Bal alul a pajzs ikon → QR-kód beolvasása egy hitelesítő alkalmazással (Google Authenticator, Microsoft Authenticator, 1Password, Authy…) → a 6 jegyű kód beírása → 8 tartalékkód jelenik meg: mentsd el / nyomtasd ki (egyszer használhatók, többször nem jelennek meg).
• Belépéskor a jelszó után a kódot kéri (vagy egy tartalékkódot). A beléptető app is kéri.
• Új tartalékkódok: aktuális kóddal generálhatók. Kikapcsolás: jelszó + kód (ha a szervezet kötelezővé tette, nem kapcsolható ki).
• Elveszett telefon: a SuperAdmin a Felhasználók között törölheti a 2FA-t („2FA ✕”), utána újra beállítható.

Jelszó

Elfelejtett jelszó: a bejelentkező oldalon „Elfelejtetted a jelszavad?” → emailben kapott link (1 óráig érvényes). Saját adatok, jelszó: Profilom.

Tevékenységnapló (Admin → Tevékenységnapló)

Minden fontos művelet naplózva: ki, mikor, mit (rendelés törlés, visszatérítés, beállítás, beléptetés, átadás, kassza eladás, 2FA…).

Automatikus védelem

Bejelentkezési kísérletek korlátozása, letiltott csapattag azonnali kiléptetése (5 percen belül), munkamenet-védelem, a Stripe értesítések hitelesítése. Minden űrlap és adatmódosító kérés CSRF-tokennel védett (idegen oldalról nem lehet a nevedben műveletet indítani), a nyilvános űrlapok (pénztár, kuponellenőrzés, várólista, regisztráció, követés, értékelés) kéréskorlátot kapnak, a feltöltött képeket a rendszer tartalom alapján ellenőrzi, és biztonsági fejlécek védik az oldalakat (pl. idegen oldalba ágyazás ellen). A szerepkörök jogosultságait a szerver minden kérésnél ellenőrzi.

23. Riportok és pénzügyek

• Riportok: eladási cél (bevétel és jegy) és tempó (hogy állsz a célhoz képest, várható végeredmény — figyelmeztetés emailben, ha elmaradsz), kapacitás jegytípusonként, bevétel és eladott jegyek naponta, „Mikor vásárolnak?” óránkénti bontás, esemény-összehasonlítás, CSV export.
• Pénzügyek: napi / heti / havi / éves bontás, eseményenkénti bontás (bruttó, visszatérítés, platform díj, Stripe díj, nettó), legutóbbi tranzakciók, és a TicketMagic számláid (platform díj).
• Bevétel csatornánként és kampányonként (Riportok): honnan jöttek a vásárlók — közvetlen, Google, Facebook/Instagram, TikTok, hírlevél, promóter, helyszíni kassza, import — rendelésszámmal, jegyszámmal és bevétellel; a kampánytáblában az UTM-paraméterek (utm_source, utm_medium, utm_campaign) szerint. Tipp: a hirdetéseid linkjeihez tegyél UTM-paramétert, pl. ?utm_source=facebook&utm_medium=paid&utm_campaign=nyari.
• Kifizetéseim: Stripe-egyenleg (kifizethető / feldolgozás alatt), a bankszámládra indult automatikus utalások, és eseményenként az elszámolás (bruttó, visszatérítés, platformdíj, kártyadíj, neked járó összeg).
• Platform díj számlák (havonta, a lezárt hónapra): levonással rendezett (kártyás rendelések — a díjat a Stripe már levonta) és utalandó (átutalásos és helyszíni eladások — 8 napos fizetési határidővel).

24. Vendégek (CRM) és kampányok

• Vendégek: minden vásárlód egy listában: rendelések száma, költés, utolsó vásárlás, részvétel, címkék, hírlevél-feliratkozás. Szűrés (szegmens): címke, esemény, min. rendelés, min. költés, „vásárolt az elmúlt … napban”. Export.
• Kampányok: levél a kiválasztott szegmensnek. Formázott szöveg (mint az email sablonoknál), kép beszúrása (feltöltés), élő előnézet, tesztlevél. Csak hírlevélre feliratkozott (és nem leiratkozott) címzettek kapják; minden levélben leiratkozó link. A küldés a háttérben, percenként néhány levéllel történik (tárhelybarát).

25. A vásárlói oldal — mit lát a vásárló

• Főoldal és eseményoldal: borítókép, időpont, helyszín, térkép, leírás, fellépők, jegyek (ár, kezelési költség, készlet-jelzés, értékesítés kezdete, láncolt körök), bérletek, extrák, asztaltérkép, nézőtér-térkép, továbbeladott jegyek, „Ki megy még?”, naptárba mentés (Apple/Outlook .ics, Google Naptár), megosztás (telefonon natív megosztó, Facebook, WhatsApp). Magyar / angol nyelvváltó (HU/EN).
• Kosár és pénztár: név, email, telefon (ha kéred), számlázási cím (ország + cím), cégként vásárlásnál adószám, születési év (ha szükséges), névesített jegyeknél a jegytulajdonosok neve, egyedi kérdések, kupon, szabályzatok elfogadása, hírlevél és „Ki megy még?” hozzájárulás, fizetési mód (kártya / átutalás).
• Fizetés: biztonságos kártyás fizetés (Stripe, a szervező színeivel; Apple Pay / Google Pay, ha elérhető).
• Visszaigazolás és rendelés oldala: jegyek (állapottal és ülőhellyel), PDF letöltés, Apple Wallet (jegyenként), Google Wallet, naptár, megosztás, visszaigazolás újraküldése, extrák utólagos vásárlása, jegyátadás, továbbeladás, átadott jegyek listája.
• Fiókom (opcionális regisztráció): korábbi rendelések, jegyek, névmódosítás (ha engedélyezett), adatok, jelszó.
• Váróterem: nagy érdeklődésnél a sorban álló látogató látja a helyét, automatikusan továbbjut.
• Szervező követése, süti-sáv, csoportos ajánlat: a vásárló követheti a szervezőt (34. fejezet), dönthet a sütikről (36. fejezet), és a jegyek mellett látja a csoportos ajánlatokat (pl. „4 jegy áráért 5”).

26. Automatikus háttérfolyamatok

A tárhelyen egyetlen cron bejegyzés kell: * * * * * php /…/cron/scheduler.php (lásd INSTALL.md).

28. Gyakori kérdések és hibaelhárítás

Nem tudom publikálni az eseményt. — Mentéskor a rendszer kiírja, mi hiányzik: fizetési mód, számlázó, email megerősítés. A vezérlőpult teendőlistája is mutatja.

A Stripe adatpótlást kér. — Beállítások → Stripe → „Részletek és pótlás”. Amíg a Stripe korlátozza a fiókot, a kártyás fizetés vagy a kifizetés szünetelhet.

Nem ment ki a számla. — Rendelések → „Számla hiányzik” szűrő: a hibaüzenet megmutatja az okot (pl. hibás API kulcs). Javítás után „Számla újrapróbálása”, vagy megvárod a 15 percenkénti automatikus próbálkozást.

A vásárló nem kapta meg a jegyet. — Rendelés → „Visszaigazolás újraküldése”, vagy a vásárló maga is újraküldheti a rendelés oldaláról. Ellenőrizd a spam mappát.

A kapunál nincs net. — Semmi teendő: az app magától offline módra vált, ha előtte egyszer (neten) letöltötte az esemény adatait. Javasolt: a kapuk nyitása előtt minden eszközön nyisd meg az eseményt neten.

Két kapu ugyanazt a jegyet engedte be offline. — A szinkron után ütközésként jelenik meg (app → Kapcsolat lap, admin → Kasszajelentés), a beléptetési naplóban látod a részleteket.

Elveszett telefon 2FA-val. — Tartalékkóddal lépj be, vagy kérd a SuperAdmint a 2FA törlésére.

Rossz jegyet olvastak be. — Admin → Rendelés → jegy → „Beléptetés visszavonása”, vagy a beléptetési naplóból.

Hogyan adhat el a vásárló jegyet úgy, hogy ne legyen feketepiac? — Kapcsold be a hivatalos továbbeladást: max. +10% felár, új QR-kód a vevőnek, a régi kód érvénytelen.

29. Telepítés és frissítés (üzemeltetőknek)

Új telepítés cPanel tárhelyre

1. Domain vagy aldomain a TicketMagicnek (a domain gyökerében kell futnia, nem almappában), bekapcsolt SSL (AutoSSL).
2. cPanel → Select PHP Version: PHP 8.1+ (8.3 ajánlott), bővítmények: pdo_mysql, mbstring, openssl, curl, json, zip, gd.
3. cPanel → MySQL Databases: új adatbázis + felhasználó, a felhasználó minden jogosultsággal az adatbázishoz rendelve. SQL-t nem kell importálni.
4. A ZIP feltöltése és kibontása a domain gyökérmappájába (Fájlkezelő → Upload → Extract). A rejtett .htaccess fájlnak is fel kell kerülnie.
5. Nyisd meg a domaint: a telepítő varázsló automatikusan elindul (/install/):
   1. ellenőrzi a rendszerkövetelményeket (piros = javítandó),
   2. adatbázis adatok — „Kapcsolat teszt” gombbal, és az oldal címe,
   3. SMTP email és Stripe platform kulcsok (kihagyható, később a config.php-ban pótolható),
   4. SuperAdmin fiók (jelszó min. 10 karakter).
6. A varázsló a végén kiírja a cron parancsot (cPanel → Cron Jobs → „Once Per Minute”) és a Stripe webhook címet (https://domain/webhook/stripe), majd lezárja magát.
7. Belépés: SuperAdmin → Beállítások, Oldalak (ÁSZF, adatvédelem, impresszum), kétlépcsős belépés.

Frissítés: az új fájlok feltöltése (a config.php és a storage/ mappa maradjon). Az első oldalbetöltéskor az adatbázis automatikusan frissül; SQL futtatás nem kell. Frissítés előtt a rendszer automatikus adatbázis-mentést készít a storage/backups/ mappába (az utolsó 5 mentés marad meg; a mappa kívülről nem elérhető). Ha valami félremenne, ebből a cPanel phpMyAdmin felületén visszaállítható.

Beállítások a config.php-ban: Stripe kulcsok és webhook titkok, SMTP, feladó név/email, időzóna, kampánylevelek percenkénti száma (campaign_per_minute).

30. Több szervezet (cég) egy fiókkal

Egy felhasználói fiók több szervezethez is tartozhat — pl. ügynökség, több céget működtető szervező, vagy kapus, aki több rendezőnek is dolgozik. A szerepkör szervezetenként eltérhet (az egyik cégnél tulajdonos, a másiknál csak beléptető).

• Szervezet nélkül nem lehet létrehozni semmit: ha a fiókodhoz még nem tartozik szervezet (vagy SuperAdminként még nem választottál), az admin a Szervezet kiválasztása oldalra visz: itt jegy alakú kártyákon látod a szervezeteidet (szerepkörrel, események számával), és itt hozhatod létre az elsőt. Amíg nincs kiválasztott szervezet, eseményt, jegyet vagy bármi mást nem lehet létrehozni.
• Váltás: a bal felső sarokban (vagy a jobb felső sarokban, a szervezet nevét mutató gombon) kattintva megnyílik a szervezetválasztó; a kiválasztott szervezet adatait látod és kezeled. A rendszer megjegyzi az utoljára használtat. Ha egy linkből (pl. emailből) másik saját szervezeted eseményét vagy rendelését nyitod meg, automatikusan arra vált.
• Új szervezet létrehozása: a szervezetválasztó alján az Új szervezet (cég, szervező) mezőbe írd be a nevet → Létrehozás. Te leszel a tulajdonosa; utána töltsd ki a Beállításokat (cégadatok, Stripe, számlázó) — minden szervezetnek saját Stripe fiókja, számlázója, arculata, eseményei és csapata van.
• Meglévő felhasználó hozzáadása: Csapattagok → Új tag → add meg az illető email címét. Ha már van TicketMagic fiókja, azt adjuk hozzá a szervezetedhez a választott szerepkörrel (a jelszava nem változik), és nála megjelenik a szervezetválasztóban.
• SuperAdmin: Felhasználók oldalon bármely felhasználót bármely szervezethez rendelheti (tulajdonosként is), szerepkört módosíthat, vagy eltávolíthat (a szervezet egyetlen tulajdonosa nem távolítható el). A SuperAdmin a szervezetválasztóban minden szervezetre átválthat.
• Beléptető app: a több szervezethez tartozó kapus egy bejelentkezéssel az összes olyan szervezet eseményét látja, ahol tulajdonos, menedzser vagy beléptető (az eseménylistán a szervezet neve is látszik).
• API kulcs mindig egy szervezethez tartozik — a váltás után az adott szervezet kulcsait kezeled.

31. API és webhookok (Admin → API és webhookok)

A szervezői API-val a saját rendszereid (weboldal, CRM, könyvelés, kapurendszer, mobilapp, Zapier/Make) hozzáférnek az eseményeidhez, jegytípusaidhoz, rendeléseidhez, jegyeidhez, vásárlóidhoz, kuponjaidhoz és vendéglistáidhoz. Teljes leírás példákkal: /fejlesztoknek (angolul: /fejlesztoknek?lang=en).

API kulcsok (csak tulajdonos / menedzser)

• Új kulcspár: megnevezés, jogosultság — teljes hozzáférés, csak olvasás, csak beléptetés (kapurendszerhez; vásárlói elérhetőséget nem lát) vagy egyedi (pipálható részjogok) —, igény szerint engedélyezett IP-címek (soronként, tartomány is: 81.182.10.0/24) és lejárati dátum (előtte 7 nappal e-mailt küldünk).
• Kapsz egy kulcsazonosítót (tmk_…) és egy titkos kulcsot (tms_…). A titkos kulcs csak a létrehozáskor látszik, „Másolás” gombbal — utána soha. Ha elveszett: új párt hozol létre, a régit törlöd.
• A listában látszik a jogosultság, a korlátok, mikor és honnan használták utoljára, hány kérés és hány hibás kérés érkezett.
• Törlés: azonnal érvénytelen. Szervezetenként legfeljebb 20 aktív kulcs. Korlát: 120 kérés / perc / kulcs.
• A Napló oldalon az „API-műveletek” összesítő mutatja kulcsonként az utolsó 30 nap kéréseit, a módosításokat, a hibákat és a legutóbbi hibás kéréseket.
• Fejlesztői dokumentáció példákkal: /fejlesztoknek (angolul: /fejlesztoknek?lang=en).

Mit tud az API (v1)?

• Események: lista, részletek, létrehozás (vázlatként), módosítás, élesítés, statisztika.
• Jegytípusok: lista, létrehozás, módosítás (ár, keret, értékesítési időszak, aktiválás…).
• Rendelések: lista szűrőkkel (esemény, állapot, email, forrás, updated_since a szinkronhoz), részletek jegyekkel, visszaigazolás újraküldése.
• Jegyek: lista, keresés QR-kód alapján, beléptetés és visszavonás (saját kapurendszerhez, karszalag-olvasóhoz), jegykiküldés (tiszteletjegy, partner, külső értékesítés).
• Vásárlók: email szerint összesítve (rendelések, költés, hírlevél-hozzájárulás).
• Kuponok: lista, létrehozás, kikapcsolás. Vendéglisták: listák, vendégek, új vendég felvétele.

Webhookok — azonnali értesítés a te rendszeredbe

• Webhook hozzáadása: a fogadó URL (nyilvános http/https cím) + események: order.paid, order.refunded, order.cancelled, ticket.checked_in, ticket.transferred, guest.checked_in.
• Létrehozáskor kapsz egy aláíró titkot (whsec_…), ezzel ellenőrizheted, hogy az üzenet tényleg tőlünk jön (X-TicketMagic-Signature fejléc — kód példák a dokumentációban).
• Kézbesítés a háttérben (percenként); sikertelenség esetén újrapróbálás 1 perc, 5 perc, 30 perc, 2 óra, 6 óra, 12 óra után. 50 egymást követő hiba után a végpont kikapcsol, és emailt kapsz.
• Teszt gomb: azonnal küld egy ping üzenetet. Kikapcsol / Bekapcsol, Töröl. Az oldal alján a legutóbbi 30 kézbesítés állapota (kézbesítve / várakozik / sikertelen, HTTP kód).

32. Díjak és ÁFA

A TicketMagic platformdíja (jegyenként, a vásárló által fizetett ár alapján):

• A platformdíj ÁFA-mentes (alanyi adómentesség), a havi platform számlán így szerepel.
• Kártyás fizetésnél a díjat a Stripe a fizetéskor automatikusan levonja; a Stripe saját kártyadíja ettől független.
• Visszatérítéskor jegyenként a hozzá tartozó platformdíj is visszajár.
• Ki fizeti? Te döntöd el: a jegytípus kezelési költségével áthárítod a vásárlóra (a „Javasolt díj” gomb kiszámolja), vagy beépíted a jegyárba (Díj beépítése a jegyárba), vagy átvállalod.
• Díjkalkulátor: a /szervezoknek oldalon bármilyen jegyárra kiszámolhatod, mennyi marad neked.

ÁFA

• A jegy ÁFA-kulcsáról (0 / 5 / 18 / 27%) te nyilatkozol jegytípusonként; a kezelési költség ÁFÁ-ja mindig ugyanez.
• 0%-nál a Beállításokban választott mentességi kód (AAM / TAM) kerül a számlára.
• A számlán: jegyek, kezelési költség, ajándék (0 Ft-os) jegyek, extrák, kupon-kedvezmény ÁFA-kulcsonként arányosan bontva.

33. Időzített levelek a vásárlóknak és értékelés (Esemény → Levelek)

Az esemény vásárlóinak a te szövegeddel, a te időzítéseddel küldhetsz e-mailt — a rendszer automatikusan kiküldi.

• Kész sablonok: Emlékeztető (alapból 1 nappal a kezdés előtt: időpont, helyszín, útvonal, jegyek linkje), Értékelő kérdőív (az esemény vége után, a belépett vendégeknek), Egyedi levél. Mindegyik szabadon átírható.
• Változók: a szövegben és a tárgyban {{nev}}, {{esemeny}}, {{datum}}, {{helyszin}}, {{cim}}, {{terkep_link}}, {{jegyek_link}}, {{pdf_link}}, {{naptar_link}}, {{rendelesszam}}, {{jegyek_szama}}, {{szervezo}}, {{kerdoiv_link}}, {{esemeny_link}} — minden címzettnél a saját adatára cserélődik. A szerkesztőben kattintással beszúrhatók.
• Formázás: félkövér, - felsorolás, szöveg, kép, gomb külön sorban: [[Felirat|{{jegyek_link}}]].
• Időzítés: X nap/óra/perc a kezdés előtt, X idővel a vége után, vagy pontos időpontban. A kezdés előtti emlékeztető a kezdés után már nem megy ki.
• Címzettek: minden vásárló, csak a belépettek, vagy csak akik nem léptek be; szűkíthető jegytípusra. Csak fizetett rendelések; vendéglistás és importált rendelések nem. Egy címre egy levélből csak egy megy ki, akkor is, ha több rendelése van.
• Előnézet és tesztlevél: élő előnézet a legutóbbi vásárló adataival; „Tesztlevél magamnak”.
• Állapot: Időzítve → Küldés alatt → Kiküldve (elküldött darabszám). Időzített levél szüneteltethető, szerkeszthető, törölhető; kiküldött levél nem módosítható.
• Értékelések: a kérdőív ({{kerdoiv_link}}) egy egyszerű oldal: 1–5 csillag + szöveges vélemény, rendelésenként egy (újraküldve felülírja). Az eredmény ugyanezen az oldalon: átlag, megoszlás, vélemények.

34. Kövesd a szervezőt (Admin → Követők)

• A vásárlói oldalakon (szervezői oldal, eseményoldal, rendelés-visszaigazolás) megjelenik a „Kövesd: <szervező>” doboz. Megadja az e-mail címét → megerősítő levelet kap (dupla megerősítés). A saját rendelése oldaláról, a rendelés e-mail címével azonnal követ.
• Ha új, nyilvános eseményt teszel közzé, a követők pár percen belül automatikusan e-mailt kapnak (borítókép, időpont, helyszín, „Részletek és jegyek” gomb). Rejtett eseményről, vázlatról és már lezajlott eseményről nem megy levél; egy eseményről csak egyszer.
• Minden levélben egy kattintásos leiratkozás.
• Admin → Követők: aktív, függő és leiratkozott követők száma, az utóbbi 30 nap, a kiküldött értesítések, a követők listája és CSV export.

35. Külső eladások importja (Esemény → Import)

Ha máshol is árultál jegyet (másik jegyrendszer, papírjegy, partner), a kódokat CSV-ben feltöltheted: a beléptető app ugyanúgy beolvassa és ellenőrzi őket — online és offline is —, mint a TicketMagic jegyeit.

• Formátum: pontosvesszővel vagy vesszővel tagolt, első sor a fejléc. Kötelező a kod oszlop (a vonalkód/QR tartalma); opcionális: nev, email, jegytipus (név szerint). Példa:

  kod;nev;email;jegytipus
  AB12345;Kiss Anna;anna@example.com;Normál

• Megadhatod a jegytípust (ha a fájlban nincs), egy megnevezést (pl. a partner neve), és hogy beleszámítson-e a jegytípus készletébe.
• A már létező kódokat a rendszer kihagyja, így ugyanaz a fájl kétszer feltöltve sem okoz duplikációt. Egy import egészében visszavonható (törlés).
• Az importált jegyekre nincs platformdíj, nem készül róluk számla és nem kapnak levelet; a riportokban külön „Import” csatornaként jelennek meg.

36. Marketing: mérőkódok, Conversions API, süti-hozzájárulás

• Kié a kód? A szervező kódjai (Beállítások → Követőkódok) a szervező saját oldalán és eseményein futnak; a TicketMagic saját kódjai (SuperAdmin állítja) csak az általános oldalakon. Így mindenki a saját hirdetéseit méri, és senki adatai nem keverednek.
• Mért események: oldalmegtekintés, esemény megtekintése (ViewContent), pénztár indítása (InitiateCheckout / begin_checkout), vásárlás (Purchase, értékkel és rendelésazonosítóval) — Meta, Google (GA4 és Ads konverzió), TikTok.
• Süti-hozzájárulás: az első látogatáskor süti-sáv jelenik meg („Elfogadom” / „Csak a szükségesek”). Mérőkód csak hozzájárulás után töltődik be. A választás a lábléc „Süti-beállítások” linkjével bármikor módosítható.
• Meta Conversions API: ha megadod a tokent, a vásárlásokat a szerver is elküldi a Metának (a böngészős pixellel azonos eseményazonosítóval, így nem duplikálódik). Csak azoknál a rendeléseknél, ahol a vásárló hozzájárult a méréshez; az e-mail cím és telefon titkosítva (SHA-256) megy át. Teszteléshez add meg a Meta Events Manager teszt eseménykódját.
• UTM és forrás: a rendszer megjegyzi, honnan érkezett a vásárló (UTM-paraméterek, Facebook/Google/TikTok kattintásazonosító, hivatkozó oldal), és a rendeléshez menti — ebből készül a csatorna- és kampányriport (23. fejezet).

37. Kereső- és AI-barát oldalak, megosztás

• Megosztás (Facebook, Messenger, WhatsApp, LinkedIn): az előnézet képe az esemény borítóképe (1,91:1, ideálisan 1200×628 vagy nagyobb), címe az esemény neve és dátuma, leírása az esemény leírása.
• Google: minden eseményoldal strukturált adatot (schema.org Event: időpont, helyszín, árak, elérhetőség, fellépők, szervező) tartalmaz, így a Google gazdag találatként, az eseménykeresőben is mutathatja. A szervezői oldal Organization, a főoldal eseménylista adatot kap. Automatikus oldaltérkép: /sitemap.xml.
• AI keresők (ChatGPT, Gemini, Claude, Perplexity stb.): a robots.txt kifejezetten engedi őket, és a /llms.txt összefoglalja az oldal szerkezetét és a közelgő eseményeket.
• Rejtett (csak linkkel elérhető) esemény nem kerül a keresőkbe és az oldaltérképbe.
• Szervezőknek oldal: /szervezoknek — bemutatkozás, díjak, díjkalkulátor, lépések, GYIK, regisztráció.

38. Idősávos jegyek (Esemény → Idősávok)

Kiállításhoz, élményprogramhoz, tárlatvezetéshez, fürdőhöz: a jegytípushoz idősávokat adsz, a vásárló a jegy mellé idősávot választ.

• Sorozat létrehozása: jegytípus, első sáv kezdete, utolsó sáv vége, milyen gyakran indul (perc), milyen hosszú (perc), keret / sáv (fő), megnevezés. Pl. 10:00–18:00, óránként, 1 órás, 30 fős → 8 sáv. Egy sáv külön is felvehető.
• Szerkesztés: kezdés, vége, keret, megnevezés, „Vásárolható” ki/be. A keret nem lehet kevesebb a már eladottnál. Törléskor, ha már van rá jegy, a sávot csak kikapcsoljuk (a meglévő jegyek érvényesek). Időpont-módosításnál a vásárlókat a Levelek a vásárlóknak funkcióval értesítheted.
• Vásárlás: az eseményoldalon a jegy mellett idősáv-választó (betelt sáv nem választható, a fogyó sávnál „még N hely”). Egy rendelésben jegytípusonként egy idősáv lehet. A keretet a rendszer párhuzamos vásárlásnál is betartja; lejárt, törölt rendelés helye automatikusan felszabadul. A jegytípus összkerete is érvényes marad.
• Jegyen: PDF-en, Apple / Google Walletben, a visszaigazoló levélben és a rendelés oldalán is látszik az idősáv.
• Beléptetés: idősávos jegy csak a sáv idejében léptethető be — a sáv előtt / után beállítható türelmi idővel (alapból 15 perccel előtte, vége után 0 perc). Online és offline módban is.
• Jegykiküldésnél (tiszteletjegy) választható idősáv. Számozott ülőhelyes jegytípushoz idősáv nem adható. A helyszíni kasszán eladott jegy idősáv nélküli (azonnal beléptethető).

39. Szervezőtársak és a számlázó cég váltása (Esemény → Szervezőtársak)

Állandó szervezőtárs (Szervezőtársak oldal, csak tulajdonos): egy másik szervezetet az összes — meglévő és jövőbeli — eseményedhez meghívhatsz. Két kapcsoló: Kezelheti az eseményeimet (ugyanúgy, mint te; a szervezeti beállításaidhoz, csapatodhoz, pénzügyeidhez nem fér hozzá) és Az esemény kezdésétől ő számlázzon. Elfogadás után az eseményeid megjelennek nála az Események között „Szervezőtárs · <cég>” címkével. A jogok bármikor módosíthatók vagy visszavonhatók; visszavonáskor a még el nem kezdődött eseményeknél a számlázás visszaáll hozzád. Minden művelete a Naplódban „[Szervezőtárs: …]” jelöléssel látszik.

Ha egy eseményt több cég közösen szervez, beállíthatod, melyik időponttól melyik cég az aktív számlázó.

• Működés: az esemény saját szervezete a kezdetektől aktív; minden szervezőtárs a saját „aktív ettől” időpontjától. Az adott pillanatban aktív cég Stripe-fiókjába / SimplePay-, Barion-, Viva Payments-fiókjába vagy bankszámlájára megy a pénz, ő állítja ki a számlát, az ő platformdíja érvényes, és a vásárló az ő fizetési módjai közül választhat. A rendelés a vásárláskor rögzíti a cégét, így a későbbi váltás a korábbi eladásokat nem érinti. A helyszíni kassza az eladás pillanatában aktív céghez könyvel.
• Meghívás: add meg a másik szervezet TicketMagic-azonosítóját (a szervezői oldal címéből: /szervezo/<azonosító>) vagy adószámát, és az átváltás időpontját. A meghívott szervezet tulajdonosa e-mailt kap, és az Admin → Szervezőtársként oldalon fogadja el (csak beállított fizetéssel és számlázással). Amíg nem fogadja el, a számlázás nem vált át.
• Időpont módosítása: bármikor átírható; a már leadott rendeléseket nem érinti. Olyan céget, amelynél már van rendelés, nem lehet eltávolítani.
• Kimutatások: minden cég Áttekintés, Pénzügyek, Kifizetések, Riportok és platformszámla oldala csak a saját eladásait mutatja. Az esemény teljes összege (minden cég együtt) a Szervezőtársak oldalon és a szervezőtárs eseményoldalán is látszik, cégenkénti bontással.
• A szervezőtárs oldala (Admin → Szervezőtársként): meghívók elfogadása / elutasítása, a saját eladások és az esemény összesen, a nála számlázott rendelések listája (a rendelés megnyitható, visszatéríthető).
• Az eseményt (jegytípusok, beállítások) továbbra is az esemény saját szervezete kezeli.

40. Fizetési szolgáltatók: Stripe, SimplePay, Barion, Viva Payments (Beállítások → Fizetési módok)

Minden szervező a saját kereskedői fiókját köti be — a vásárlók pénze közvetlenül hozzá érkezik. A pénztárban a vásárló a bekapcsolt módok közül választ (Stripe, SimplePay, Barion, Viva Payments, átutalás). A SimplePay / Barion / Viva Payments rendelések platformdíja — az átutaláshoz hasonlóan — a havi utalandó platformszámlán szerepel.

• A titkos kulcsokat titkosítva tároljuk; a mezőt üresen hagyva megmarad a régi érték, „-” beírásával törölhető.
• Teszt (sandbox) mód: kapcsold be, amíg próbálsz — ilyenkor a szolgáltató tesztrendszerét használjuk, valódi terhelés nincs. Élesítés előtt kapcsold ki.
• Fizetés menete: a vásárló a szolgáltató biztonságos fizetőoldalára kerül, majd vissza a rendelése oldalára. A fizetés tényét és összegét a rendszer mindig közvetlenül a szolgáltatótól kérdezi le (a visszairányítás adatait önmagukban nem fogadja el). Ha a vásárló félbehagyja, a rendelés oldalán a „Fizetés” gombbal újrakezdheti; 45 perc után a rendszer még egyszer ellenőriz a szolgáltatónál, és ha nem fizettek, lejáratja a rendelést.
• Visszatérítés: a rendelés oldalán ugyanúgy, mint a kártyás fizetésnél (egész rendelés vagy jegyenként) — a rendszer a szolgáltatónál indítja.
• Minden szolgáltatói üzenetet naplózunk (hibakereséshez).

SimplePay segédlet

1. Szerződj az OTP Mobil Kft.-vel (simplepay.hu → Webáruházaknak). A szerződéskötéskor a webáruház címe: https://ticketmagic.hu/szervezo/<azonosítód>.
2. A SimplePay kereskedői felületén (Admin) nézd meg a HUF-os fiókod adatait: Kereskedői azonosító (MERCHANT) és Titkos kulcs (SECRET KEY).
3. Állítsd be az IPN URL-t: https://ticketmagic.hu/webhook/simplepay.
4. TicketMagic → Beállítások → Fizetési módok → SimplePay: Bekapcsolva + Teszt mód, add meg a két adatot, Mentés.
5. Próbavásárlás a SimplePay tesztkártyájával (sandbox), majd a SimplePay élesítési ellenőrzése után kapcsold ki a Teszt módot.
6. A pénztárban a SimplePay választásakor megjelenik a kötelező adattovábbítási nyilatkozat (a Beállítások cégnevével és címével), a visszatérés után pedig a SimplePay tranzakcióazonosító — ezek a SimplePay elvárásai.

Barion segédlet

1. Regisztrálj üzleti Barion-fiókot (barion.com), és hozz létre egy üzletet (shop); jóváhagyás után kapod meg a POSKey-t (Üzleteim → Részletek → titkos kulcs).
2. A kedvezményezett: a Barion-fiókod e-mail címe (ide érkezik a pénz).
3. A Barion Pixel kötelező: a pixel azonosítót (BP-…) a fiókodban találod; a TicketMagic az eseményoldaladon és a pénztárban beágyazza (alap mód).
4. TicketMagic → Beállítások → Fizetési módok → Barion: Bekapcsolva + Teszt mód, POSKey, e-mail, Pixel azonosító, Mentés. Teszteléshez a Barion tesztrendszerében (test.barion.com) külön tesztfiókra és POSKey-re van szükség.
5. A visszairányítási és értesítési címet a TicketMagic minden fizetésnél automatikusan megadja, a Barionban nincs teendő.

Viva Payments segédlet

1. Nyiss Viva Payments üzleti fiókot (vivawallet.com / viva.com) HUF pénznemmel.
2. Viva Payments felület → Settings → API Access: itt találod a Merchant ID-t és az API Key-t, valamint a Smart Checkout Credentials alatt a Client ID-t és a Client Secret-et.
3. Sales → Online payments → Websites/Apps: hozz létre egy fizetési forrást (Source): Success URL: https://ticketmagic.hu/fizetes/visszahivas/viva, Failure URL: https://ticketmagic.hu/fizetes/visszahivas/viva-hiba. A forrás 4 jegyű kódja a Source Code.
4. TicketMagic → Beállítások → Fizetési módok → Viva Payments: Bekapcsolva + Teszt mód, Client ID, Client Secret, Source Code, Merchant ID, API Key, Mentés.
5. Settings → API Access → Webhooks: új webhook, URL: https://ticketmagic.hu/webhook/viva/<a szervezeted száma> (a pontos címet a Beállítások oldalon látod), esemény: Transaction Payment Created. A Viva Payments a mentéskor ellenőrzi a címet — a TicketMagic automatikusan válaszol.
6. Teszteléshez a Viva Payments demo fiókja (demo.vivapayments.com) kell; élesítés előtt kapcsold ki a Teszt módot.

41. NTAK adatgyűjtés (Beállítások → NTAK, Esemény → NTAK-adatok)

Ha a rendezvényeidre NTAK-adatszolgáltatás vonatkozik (jegyes attrakció / rendezvény, a jogszabályi árbevétel-határ felett), kapcsold be az adatgyűjtést. Az automatikus beküldéshez MTÜ-tanúsítvány szükséges — ez később érkezik; addig a TicketMagic összegyűjti és letölthetővé teszi az adatokat.

• Beállítások → NTAK adatgyűjtés: bekapcsolás és az NTAK regisztrációs szám. Bekapcsolva megjelennek az NTAK-mezők az eseményeken és a jegytípusokon.
• Esemény szerkesztése → NTAK-adatok: programazonosító (ha több értékesítő árulja ugyanazt az eseményt, mindenkinek ugyanazt kell használnia; üresen automatikus), program típusa, fő- és alkategória (a hivatalos NTAK-szótár szerint), gyakoriság.
• Jegytípus: NTAK jegykategória (pl. teljes árú, kedvezményes, diák, családi) és hogy hány főre szól a jegy.
• Mit gyűjtünk: program (név, helyszín, kezdés, vége, kategóriák), tranzakciók (időpont, fizetési mód és összeg, értékesítési csatorna — online / helyszíni, a vásárló irányítószáma vagy országa, nem jegy jellegű tételek), eladott jegyek (azonosító, név, kategória, bruttó ár, ÁFA-kulcs, kedvezmény, személyek száma, érvényesség — idősávos jegynél a sáv), sztornók, belépések. A 0 Ft-os és az importált jegyeket nem számoljuk.
• Esemény → NTAK-adatok: hiánylista (mi kell még), összesítő, és letöltés JSON-ben (NTAK-szerkezethez igazítva) vagy CSV-ben (jegyenként egy sor).

42. Promóter és értékesítő felület (/promoter, /sales)

Két külön, egyszerű felület azoknak, akik nem kezelik a szervezetet, csak jegyeket adnak el vagy promótálnak. Semmi mást nem látnak, csak azt, ami ehhez kell.

• Jogosultság adása (Csapattagok → Promóterek és értékesítők): e-mail cím, jogosultság (Promóter vagy Értékesítő), esemény (a szervező összes aktuális eseménye vagy egy konkrét esemény), mit tehet (fizetős jegyet adhat el, tiszteletjegyet adhat ki — kerettel, eseményenként), promóternél a jutalék. Bárkinek adható: szervezői fióknak, csak vásárlói fióknak (ugyanazzal a jelszóval lép be), vagy még regisztrálatlan e-mail címnek (meghívót küldünk a jelszó beállításához). Visszavonás egy kattintással. Csak tulajdonos / menedzser adhat jogot.
• SuperAdmin (Felhasználók): bármelyik e-mail címet bármelyik céghez rendelheti — szervezeti szerepkörrel (kezelheti a céget) vagy promóter / értékesítő jogosultsággal, a szervező és az esemény kiválasztásával. A keresés a csak vásárlói fiókokat is mutatja.
• /promoter: promóter-kód és -link eseményenként (másolás gombbal), kattintások, eladott jegyek, függő / jóváhagyott / kifizetett jutalék, a csapata (ha csapatvezető), a jutalékai tételesen és a vendéglistái. Ha a jogosultsága engedi, ő is eladhat vagy tiszteletjegyet adhat ki — ezek a jutalékához számítanak.
• Beléptető jogosultság: a „Beléptető (jegyellenőrzés)” jogosultsággal bárki (szervezői vagy vásárlói fiókkal) beléptethet a /belepteto oldalon — a szervező összes aktuális eseményére vagy egyetlen eseményre. Belépés után csak azokat az eseményeket látja, amelyekhez joga van; laptopon webkamerával, telefonon kamerával olvas QR-kódot, offline is működik.
• Mobilapp: a mobile-app/ mappa egy kész Capacitor-keret (Android / iOS), amely a /belepteto oldalt tölti be teljes képernyőn; építése és kiadása a mappa README-jében. Telepítés nélkül is használható: a /belepteto PWA, telefonon „Hozzáadás a kezdőképernyőhöz”.
• /sales: a jogosultsághoz tartozó események (szervezőre szóló jognál a szervező összes aktuális eseménye). Eseményt választva: jegytípusok és mennyiség (idősávval, ha van), vevő / jegytulajdonos (név, e-mail, telefon, ország, számlázási cím, céges számla adószámmal, születési év ha kell, jegyenként eltérő tulajdonos), az esemény egyedi kérdései, majd a fizetési mód:
  • Készpénz / Bankkártya (terminál): azonnal fizetett, a jegy érvényes; helyszíni eladásnál a vevő adatai elhagyhatók (a jegy a rendelés oldaláról nyomtatható). Helyszíni pénztárnak is ez való.
  • Átutalás: a vevő megkapja az utalási adatokat, a jegy az utalás beérkezésekor aktiválódik.
  • Fizetési link (online): a vevő e-mailben fizetési linket kap; a jegyeket a megadott ideig (2 órától 7 napig) foglaljuk.
  • Tiszteletjegy (0 Ft): számla és platformdíj nélkül, azonnal kiküldve, a keret erejéig.
• Eladásaim: a saját eladások listája, kassza-összesítő fizetési módonként, rendelésenként a jegyek, és a jegyek / fizetési link újraküldése (akár másik e-mail címre).
• Egy fiók mindenhez: aki szervező, ugyanazzal az e-mail címmel és jelszóval vásárlóként is beléphet a jegyvásárló oldalon (a vásárlói fiók automatikusan létrejön), és vásárolhat, mint bárki más. Fordítva: a vásárlói fiókkal rendelkező kaphat promóter / értékesítő jogot vagy cégkezelést.

v34 — Visszatérítések átláthatósága, beléptetés, biztonság

Visszatérítések naplója

Rendelések → Visszatérítések menüben minden visszatérítés látszik: összeg, fizetési mód, állapot (Szolgáltató elfogadta, Kézi utalásra vár, Visszautalva, Sikertelen), a szolgáltató azonosítója (pl. Stripe re_…), ki indította és miért, és mikor kapta meg a vásárló az értesítőt. Ugyanez a rendelés oldalán is megjelenik.

• Online fizetés (Stripe, SimplePay, Barion, Viva Payments): a pénz automatikusan visszamegy, a vásárló 5–10 munkanapon belül látja.
• Átutalás, készpénz, terminál: a pénzt te utalod vissza, utána nyomd meg a ✓ Visszautalva gombot (megjegyzés megadható) — a vásárló erről is e-mailt kap.
• Értesítő újraküldése gombbal bármikor újra elküldheted a vásárlónak.

Mit lát a vásárló?

E-mailt kap arról, hogy mely jegyei lettek érvénytelenítve, mennyit és milyen módon kap vissza (elmaradt eseménynél a szervező üzenetével). A rendelése oldalán a jegyeknél „Érvénytelenítve — visszatérítve” felirat, felül a visszatérítés állapota. A sablonok szövege az Email sablonok menüben szerkeszthető.

Ha egy fizetés a rendelés lejárta után érkezik meg (vagy sikertelen a továbbeladott jegy átadása), a rendszer automatikusan visszatéríti és értesít mindenkit.

Belépések száma jegyenként

A jegytípusnál megadható, hányszor léptethető be egy jegy (alap: 1). Pl. kiengedés–visszaengedéshez 2–3. Két belépés között legalább 2 percnek el kell telnie, így a QR-kódot nem lehet a kerítésen át visszaadni. A beléptető app kiírja: „2/3. belépés”.

Beléptetés visszavonása

Csak a tulajdonos és a menedzser vonhat vissza beléptetést, kötelező indoklással; a Tevékenységnaplóban megmarad. A beléptető appban nincs visszavonás.

Biztonság

• Átutalás beérkezését csak tulajdonos / menedzser igazolhatja (értékesítő nem).
• Meglévő szervezői e-mail címmel nem lehet újra regisztrálni; vendégvásárlásból fiókot csak az e-mail cím megerősítése után lehet igényelni.
• Túl sok hibás jelszó után a fiók 15 percre zárolódik.
• Korlátozott kupon párhuzamos vásárlással sem használható a kereten túl.

v35 — Meglévő Stripe-fiók, adószám / cégjegyzékszám

Már van Stripe-fiókod? (pl. más jegyrendszerhez vagy webshophoz) A Beállításokban válaszd a „Már van Stripe-fiókom — összekapcsolás” gombot: bejelentkezel a Stripe-ba, jóváhagyod a kapcsolatot, és nem kell új fiókot nyitnod, sem újra igazolnod magad. Új fiók nyitásakor a Stripe törvényi kötelezettség miatt (pénzmosás elleni szabályok) mindig ellenőrzi a képviselő személyazonosságát; ez a lépés „Most kihagyom”-mal elhalasztható, de a kifizetésekhez később pótolni kell.

Adószám és cégjegyzékszám: ha véletlenül felcserélve adod meg (adószám: 12345678-2-06, cégjegyzékszám: 06-09-008275), a rendszer felismeri és kijavítja, a Stripe is a helyes adatokat kapja.

v36 — Egyszerűsített Stripe-fiók és késleltetett kifizetés

Csatlakozás: a „Stripe fiók csatlakoztatása” gomb egy rövid, egyszerűsített Stripe-oldalra visz (cégadatok, bankszámla, személyazonosság igazolása). Utána a Stripe-pal szinte nem kell foglalkoznod: az eladásokat, visszatérítéseket és kifizetéseket a TicketMagicben látod. A pénz a saját Stripe-fiókodba érkezik, a TicketMagic csak a platformdíjat kapja.

Stripe-fiókom megnyitása: a Beállítások → Stripe résznél ezzel a gombbal nézheted meg a kifizetéseidet, és módosíthatod a bankszámládat.

Kifizetés: alapesetben a Stripe rendszeresen utalja a bevételt a bankszámládra. Ha a platform késleltetett kifizetést állított be, a kártyás bevételt az esemény vége után a megadott számú nappal utaljuk; addig a pénz a saját Stripe-fiókodban van (elmaradt eseménynél így van miből visszatéríteni). A Beállításokban mindig látod, nálad melyik érvényes.

Már van saját Stripe-fiókod? Továbbra is összekapcsolhatod a „Már van Stripe-fiókom” gombbal.