Documentatie / Gidsen / Tickets scannen
ProtocolspecificatieAPI-referentieGidsen
Documentatie / Gidsen / Tickets scannen
GUIDE · V1

Tickets scannen

Camera scannen, validatieresultaten, check-in flow

De scanner openen

Tik op Tickets scannen vanaf het startscherm om de camerascanner te openen.

Als dit uw eerste keer is, vraagt de app om cameratoegang. U moet deze verlenen om de scanner te kunnen gebruiken.

Cameraweergave

De scanner toont:

  • Camerabeeld op volledig scherm
  • Een overlay-kader dat aangeeft waar u moet richten
  • Een sessie-scanteller onderaan (bijv. "5 gescand")
  • Een sluitknop in de bovenhoek

Een QR code scannen

  1. Richt de camera op een ticket-QR code
  2. De code wordt automatisch gedetecteerd
  3. Een haptische trilling bevestigt de detectie
  4. Het resultaatvenster verschijnt

Een vertraging van 3 seconden voorkomt dat dezelfde QR code twee keer snel achter elkaar wordt gescand.

Resultaatvenster

Na het scannen toont een venster het validatieresultaat.

Statusicoon

Bovenaan het venster wordt een gekleurde cirkel met een icoon getoond:

  • Groene cirkel met vinkje voor geldige tickets
  • Amber cirkel met waarschuwingsdriehoek voor waarschuwingscondities
  • Rode cirkel met X voor fouten

Ticketdetails

Als de QR code geldige ticketgegevens bevat, toont het venster:

Veld Beschrijving
Houder Naam van de tickethouder
Type Tickettype (bijv. "Standaard Toegang")
Evenement Evenementnaam
Datum Evenementdatum en -tijd
Ingecheckt om Tijd van eerdere check-in (alleen voor reeds gebruikte tickets)

Scanresultaatstatussen

Status Icoon Kleur Betekenis
Geldig ticket Vinkje Groen Ticket is geldig en klaar om in te checken
Al ingecheckt Waarschuwing Amber Ticket is al gescand; check-in tijd wordt getoond
Ticket ingetrokken X Rood Ticket is ingetrokken door de organisator
Ticket verlopen Waarschuwing Amber De vervaldatum van het ticket is verstreken
Verkeerd evenement Waarschuwing Amber Ticket is voor een ander evenement dan waarvoor deze scanner is ingeschreven
Ticket niet gevonden X Rood Ticket-ID wordt niet herkend door de server
Ongeldig ticket X Rood Verificatie van de digitale handtekening is mislukt (mogelijke vervalsing)
Ongeldige QR code X Rood QR code is geen geldig ticketformaat
Niet ingeschreven Waarschuwing Amber Scanner is niet ingeschreven voor het evenement van dit ticket. Toont de evenementnaam
Onbekende uitgever Waarschuwing Amber Publieke sleutel van de uitgever niet gevonden; kan de handtekening niet verifieren
Al gebruikt (lokaal) Waarschuwing Amber Al lokaal gescand in deze sessie (offline duplicaatdetectie)
Verkeerde poort Waarschuwing Amber Ticket is geldig maar niet toegewezen aan de poort van deze scanner

Check-in flow

Wanneer een ticket Geldig is:

  1. Het venster toont de ticketdetails en een knop Markeren als gebruikt
  2. Tik op Markeren als gebruikt om de deelnemer in te checken
  3. De app stuurt de check-in naar de server
  4. Bij succes: groene haptische feedback, het venster sluit en de scanteller wordt verhoogd
  5. Als u niet wilt inchecken, tik op Annuleren om het venster te sluiten

Voor alle andere statussen toont het venster een knop Sluiten om te sluiten en door te gaan met scannen.

Offline check-in

Als de server niet bereikbaar is wanneer u op Markeren als gebruikt tikt:

  1. De check-in wordt lokaal in de wachtrij geplaatst
  2. Het venster toont "Toegelaten (wacht op synchronisatie)"
  3. Groene haptische feedback bevestigt de toelating
  4. De check-in wordt opgeslagen in de lokale scangeschiedenis met de status "Wacht op synchronisatie"

De check-in in de wachtrij wordt automatisch gesynchroniseerd wanneer de verbinding is hersteld. Zie Offline modus voor details.

Tips

  • Houd de telefoon stil op ongeveer 15-20 cm van de QR code voor de beste resultaten
  • Zorg voor voldoende verlichting; de camera moet de QR code duidelijk kunnen zien
  • Als een QR code niet wordt gedetecteerd, probeer dan de hoek of afstand aan te passen
  • De sessieteller wordt gereset telkens wanneer u de scanner verlaat en opnieuw opent