Leitfaden: CodeB Wallet einbinden
Für Organisationen, die mit CodeB Wallet Nachweise anfragen, Karten ausstellen oder Unterschriften einholen: eine Schaltfläche je Aktion, ein QR-Rahmen und ein Leser-Aufkleber, alles im eigenen CodeB-Design. Die Regeln gelten gleich auf der Website, am Schalter, auf Papier und an Tür oder PC.
Fünf Grundsätze
- Dort anbieten, wo entschieden wird – neben dem Formular, Bezahlschritt oder der Anmeldung, die es ersetzt, nie versteckt in einem Menü.
- Vor dem Tippen sagen, was Sie wissen wollen und wozu – eine Zeile unter der Schaltfläche, etwa „Wir prüfen, ob Sie über 18 sind. Name und Geburtsdatum sehen wir nicht.“
- Die Person startet – nichts öffnet die Wallet oder zeigt einen QR-Code, bevor die Person tippt oder das Personal fragt.
- Immer ein Weg zurück und ein anderer Weg – wer CodeB Wallet oder das Telefon nicht dabeihat, bekommt auf derselben Seite eine andere Möglichkeit.
- Jedes Ergebnis in klaren Worten – Erfolg, Abbruch und Fehler bekommen je einen kurzen Satz und einen nächsten Schritt, nie nur einen Fehlercode.
Vier Aktionen, feste Beschriftungen
Wählen Sie die Aktion, nie eine eigene Beschriftung. Die Schaltfläche öffnet den passenden App-Link von CodeB Wallet.
| Aktion | Englisch | Deutsch | Maltesisch |
|---|---|---|---|
| Nachweisen – Identität, Alter oder eine Karte (OpenID4VP) | Verify with CodeB Wallet | Mit CodeB Wallet nachweisen | Ivverifika b’CodeB Wallet |
| Hinzufügen – Karte oder Dokument ausstellen (OpenID4VCI) | Add to CodeB Wallet | Zu CodeB Wallet hinzufügen | Żid ma’ CodeB Wallet |
| Signieren – PDF-Unterschrift anfragen | Sign with CodeB Wallet | Mit CodeB Wallet signieren | Iffirma b’CodeB Wallet |
| Öffnen – die Seite öffnet nur einen Bereich der Wallet (z. B. Ausweis lesen, Konto) | Open CodeB Wallet | CodeB Wallet öffnen | Iftaħ CodeB Wallet |
Die Schaltfläche
Abgerundetes Rechteck, links das runde rote CodeB-Zeichen, eine Textzeile. Marineblau #0B3A8A mit weißer Schrift auf hellem Hintergrund; Weiß mit marineblauer Schrift und Rand auf dunklem Hintergrund. 56 px hoch, nie unter 48 px, mindestens 28 px Freiraum rundum.
Nicht erlaubt: andere Farben, eine andere Beschriftung, das Zeichen allein als Schaltfläche, Verzerren, Schatten, Animation oder Ihr eigenes Logo in der Schaltfläche.
Online: Telefon und Computer
Auf dem Telefon öffnet die Schaltfläche CodeB Wallet direkt. Am Computer öffnet sie einen Dialog mit QR-Code, Link zum Abtippen und „Auf diesem Gerät öffnen“. In beiden Fällen sieht die Person in der Wallet, was gefragt ist, und bestätigt.
Der Dialog zeigt drei Zustände in klaren Worten: Warten („Öffnen Sie CodeB Wallet und bestätigen Sie“), Fertig („Danke – bestätigt“, die Seite geht von selbst weiter) und Nicht abgeschlossen (was passiert ist, in einem Satz, und eine Schaltfläche zum Wiederholen). Neben der Schaltfläche: „Kein CodeB Wallet? Bei Google Play laden“ und Ihr anderer Weg.
Vor Ort und auf Papier: der QR-Rahmen
Am Schalter, am Kiosk-Bildschirm oder auf Papier steht der QR-Code immer im CodeB-Rahmen: Kopfzeile mit Zeichen, Code auf Weiß und ein Link zum Abtippen für alle, die nicht scannen können. Der Code ist auf Papier mindestens 30 mm und am Bildschirm 200 px breit. Das Personal startet eine Anfrage nur, wenn die Person es möchte, und der Bildschirm zeigt das Ergebnis in Worten, etwa „Alter bestätigt“.
CodeB Wallet nutzt denselben Rahmen, wenn Sie die App mit jemandem teilen.
Türen und PCs: der Leser-Aufkleber
Leser, die CodeB-Karten per NFC annehmen – Türleser und PCs für die les- und beschreibbare und die nur lesbare PKI-Karte –, tragen den runden Aufkleber „CodeB Wallet hier hinhalten“, 40 oder 60 mm, mittig auf der Antenne. Der Hinweis „Karte öffnen, dann antippen“ ist wichtig: Eine Karte antwortet erst, wenn die Person sie in der App wählt, nur kurze Zeit und nur bei entsperrtem Telefon. Am Leser eines anderen Herstellers klebt er neben dessen Symbol, nie darüber.
Formulierungen und Barrierefreiheit
Schreiben Sie „CodeB Wallet“ (zwei Wörter, großes C und B), nennen Sie die Karten so wie die App und beschreiben Sie, was geteilt wird („Ihr Alter“). Nennen Sie nichts „offiziell“, „zertifiziert“ oder „staatlich anerkannt“ und zeigen Sie nie nur einen Fehlercode.
Verwenden Sie eine echte Schaltfläche oder einen Link, dessen zugänglicher Name der sichtbaren Beschriftung entspricht, per Tastatur erreichbar und mit sichtbarem Fokusrahmen; Kontrast mindestens 4,5:1 (beide Varianten erfüllen das). Im QR-Dialog bleibt der Fokus im Dialog, Escape schließt ihn, und Statuswechsel werden Screenreadern angesagt. Die Sprache der Beschriftung folgt der Seitensprache.
Vorlagen-Paket
Schaltflächen (Marineblau und Weiß, Englisch, Deutsch und Maltesisch – Spanisch und Finnisch folgen), QR-Rahmen-Vorlagen für Bildschirm und Druck sowie der Leser-Aufkleber stehen CodeB-Kunden und -Partnern zur Verfügung. Fragen Sie uns nach dem Paket.
Fragen von Partnern
Wie binde ich eine Schaltfläche „Mit CodeB Wallet nachweisen“ auf meiner Website ein?
Nutzen Sie die marineblaue Schaltfläche (auf dunklem Hintergrund die weiße) mit der festen Beschriftung Ihrer Aktion und verlinken Sie Ihre OpenID4VP-Anfrage. Auf dem Telefon öffnet sie CodeB Wallet direkt, am Computer zeigen Sie den QR-Rahmen mit Link zum Abtippen. Das Vorlagen-Paket bekommen Sie bei uns.
Welche Protokolle starten die Schaltflächen?
Nachweisen startet eine OpenID4VP-Anfrage, Hinzufügen ein OpenID4VCI-Angebot, Signieren eine CodeB-Signaturanfrage und Öffnen einen Bereich der Wallet. CodeB Wallet nimmt auch die Standard-Links openid4vp://, haip-vp:// und haip:// an.
Können Menschen auf meiner Seite auch eine andere EU-Wallet nutzen?
Ja. Lassen Sie neben der CodeB-Schaltfläche einen kleinen Textlink zur Standard-Anfrage stehen, damit niemand mit einer anderen Wallet ausgeschlossen wird.
Brauche ich für Türen oder PCs einen CodeB-Leser?
Nein. Jeder Leser, der CodeB-Karten per NFC annimmt, kann den Aufkleber tragen – neben dem Symbol des Herstellers, nie darüber.
Ist CodeB Wallet zertifiziert oder offiziell?
Beschreiben Sie sie nicht als offiziell, zertifiziert oder staatlich anerkannt. Beschreiben Sie, was geteilt wird, etwa „Ihr Alter“.