QR-codes.
Gifty maakt gebruik van QR-codes om cadeaubon-codes te coderen. Deze QR-codes kunnen een volledige URL bevatten die verwijst naar ons walletsysteem of een eenvoudige identificatiecode. Dit artikel beschrijft de technische details van onze QR-code-implementatie en geeft richtlijnen voor het correct configureren van scanners met kassasystemen.
Code-structuur
Onze QR-codes ondersteunen twee formaten om te voldoen aan verschillende integratievereisten en systeemmogelijkheden:
URL-formaat
Het primaire formaat bevat een volledige URL die verwijst naar ons walletsysteem. Deze URL bevat de cadeaubon-identificatiecode en biedt directe toegang tot de digitale wallet-interface.
De URL-structuur bestaat uit:
- Een domeinnaam (afhankelijk van de implementatie)
- Eén of meerdere segmenten die de cadeaubon-identificatiecode bevatten
- Alleen hoofdletters (A-Z) en cijfers (0-9)
Direct formaat (legacy)
Voor compatibiliteit met oudere systemen en specifieke integratievereisten ondersteunen we ook een vereenvoudigd formaat dat alleen de cadeaubon-identificatiecode bevat. Deze legacy codes kunnen enkel door Gifty ingeschakeld worden en gelden dan voor het gehele account. Dit formaat kan gebruikt worden wanneer:
- Het kassasysteem beperkte mogelijkheden heeft voor URL-verwerking
- Cadeauboncodes worden geïmporteerd uit externe systemen
- Dit voor een specifieke integratie gewenst is
Technische implementatie
Onze QR-codes maken gebruik van UTF-8-codering en bevatten Extended Channel Interpretation (ECI)-informatie. Dit zorgt voor brede compatibiliteit met moderne scanners.
URL-formaat QR-codes bevatten:
- Alleen ASCII-tekens (codes 0-127)
- Hoofdletters en cijfers (A-Z, 0-9)
- Essentiële URL-tekens (schuine streep, punt, dubbele punt)
Direct formaat (legacy) QR-codes bevatten:
- Alleen hoofdletters en cijfers (A-Z, 0-9)
Scannerconfiguratie
De meeste barcodescanners kunnen op twee manieren worden geconfigureerd:
Configuratie via barcodes (meest voorkomend)
- Zoek de handleiding van de scanner
- Ga naar de sectie met instellingen voor QR- of 2D-barcodes
- Scan de configuratiebarcodes om wijzigingen door te voeren
Softwareconfiguratie
- Sluit de scanner aan op een computer met de software van de fabrikant
- Ga naar de instellingen voor QR- of 2D-barcodes
- Pas de configuratie aan en sla de wijzigingen op in de scanner
Algemene scannerinstellingen
Om een barcode scanner te laten werken met Gifty QR-codes raden we de volgende instellingen aan:
- Stel de primaire codering in op UTF-8
- Schakel URL-voorverwerking (preprocessing) uit
- Voorkom dat de scanner voorvoegsels of achtervoegsels toevoegt
- Schakel ruwe datatransmissie (raw data transmission) in
- Controleer of de maximale string-lengte voldoende is
Validatie en testen
Een correct geconfigureerde scanner moet de volledige QR-code-inhoud zonder wijzigingen weergeven. Dit kan worden gecontroleerd door QR-codes in te scannen en de uitvoer te bekijken in een eenvoudige teksteditor, zoals Kladblok (Windows) of Tekteditor (macOS).
URL-formaat
Verwachte uitvoer: https://wallet.gifty.nl/ABCDABCDABCDABCD/123456
Direct formaat
Verwachte uitvoer: ABCDABCDABCDABCD
Veelvoorkomende problemen
| Probleem | Oplossing |
|---|---|
| Extra tekens in de uitvoer: \000026https://wallet.gifty.nl/... | De scanner voegt controlekarakters toe. Schakel speciale tekenverwerking uit in de scannerinstellingen. |
| Ingekorte tekst | Controleer of de maximale stringlengte van de scanner groot genoeg is. |
| Verkeerde of vreemde tekens | Controleer of UTF-8-ondersteuning correct is ingeschakeld. |