GitHub

AgeChecker

Inhaltsverzeichnis

Kostenlose 15-minütige Erstberatung direkt mit unseren Experten.

Kostenlose Beratung +49 421 438 1919-0

Einführung

Das AgeChecker Plugin für Shopware 6 ist eine leistungsstarke Lösung, die Händlern dabei hilft, die Altersverifikation auf ihren Online-Shops durchzusetzen. Durch die Integration mit einem zuverlässigen externen Altersprüfungsdienst stellt das Plugin sicher, dass Kunden die erforderlichen Altersanforderungen erfüllen, bevor sie Produkte einsehen oder einen Kauf abschliessen können.

Dieses Plugin ist besonders nützlich für Unternehmen, die altersbeschränkte Produkte wie Alkohol, Tabak oder Inhalte für Erwachsene verkaufen, da es eine zuverlässige und rechtlich konforme Schutzebene für Händler und Kunden bietet. AgeChecker ist flexibel konfigurierbar, sodass Shop-Betreiber den Verifizierungsprozess an ihre spezifischen Anforderungen anpassen können, ohne dass das Einkaufserlebnis darunter leidet.

Das Plugin integriert sich nahtlos in die Verkaufskanäle von Shopware und führt die Altersverifikation automatisch an wichtigen Punkten der Customer Journey durch, einschliesslich Produktseiten, Warenkorb und Checkout. Durch den Einsatz von AgeChecker können Händler rechtliche Risiken minimieren, die Compliance verbessern und eine professionelle, vertrauenswürdige Einkaufsumgebung bieten, die Kunden beruhigt und gleichzeitig das Geschäft schützt. Auch für Onlinehändler in der Schweiz, die Alkohol, Tabakprodukte oder andere altersbeschränkte Waren verkaufen, ist eine zuverlässige Altersprüfung im Checkout ein wichtiger Baustein.

Hauptfunktionen

Integration der Sales Channels
Fügen Sie API-Keys pro Sales Channel für eine flexible Konfiguration hinzu.

1.Altersverifikationsoptionen
Kunden können ihr Alter überprüfen, indem sie ihr Geburtsdatum eingeben.

2.Retry-Management
Standardmässig haben Benutzer 3 Versuche, ihr Alter zu verifizieren.

3.Temporäre Sperrlogik
Benutzer werden nach 3 fehlgeschlagenen Versuchen vorübergehend blockiert.

4.Konfiguration im Admin-Panel
Einstellungen lassen sich einfach über das Shopware-Admin-Panel verwalten.

Kompatibilität

  • ✅ Shopware 6.6.x

Loslegen

Installation & Aktivierung
1.Download

Git

  • Plugin-Repository klonen:

  • Öffnen Sie Ihr Terminal und führen Sie im Verzeichnis für eigene Plugins Ihrer Shopware-6-Installation (meist custom/plugins/) folgenden Befehl aus:

git clone https://github.com/solution25com/agechecker-shopware-6-solution25.git

Packagist 

composer require solution25/age-checker

2.Plugin in Shopware 6 installieren

  • Melden Sie sich im Shopware-6-Administrationsbereich an.

  • Navigieren Sie zu Erweiterungen > Meine Erweiterungen.

  • Suchen Sie das neu geklonte Plugin und klicken Sie auf Installieren.

3.Plugin aktivieren

  • Nach der Installation klicken Sie auf Aktivieren oder schalten Sie das Plugin um, um es zu aktivieren.

4.Installation überprüfen

  • Nach der Aktivierung sehen Sie AgeChecker in der Liste der installierten Plugins.

  • Der Plugin-Name, die Version und das Installationsdatum sollten angezeigt werden, wie im Screenshot unten dargestellt.

438103110 719ab524 7636 45b9 966a 66670f356c47 1

Plugin-Konfiguration

1.Zugriff auf die Plugin-Einstellungen

  • Gehen Sie zu Einstellungen > System > Plugins.

  • Suchen Sie AgeChecker und klicken Sie auf das Drei-Punkte-Symbol (…) oder den Plugin-Namen, um die Einstellungen zu öffnen.

2.API-Key einrichten

  • Gehen Sie zu Erweiterungen > Meine Erweiterungen > AgeChecker.

  • Wählen Sie den entsprechenden Sales Channel aus.

  • Geben Sie den von AgeChecker.net bereitgestellten API-Key ein. Sie müssen dort ein Konto erstellen, um Ihren API-Key zu erhalten.

438103364 01e9a268 1dae 4eea B6dd Db453b959765 1

3.Konfiguration speichern

  • Klicken Sie oben rechts auf Speichern, um Ihre Einstellungen zu sichern.

Funktionsweise

1.Benutzer startet den Checkout

  • AgeChecker löst ein Popup basierend auf der konfigurierten Methode aus.

2.Verifikationsversuch

  • Der Benutzer gibt sein Geburtsdatum ein.

438103650 Cfc8b2aa Edb9 4d43 996b E395f9223d11 1

  • Bei erfolgreicher Verifizierung wird der Checkout fortgesetzt.

438103745 3f110c91 8364 4093 A441 Deab0a3385d5 1

  • Bei fehlgeschlagener Verifizierung:

Der Benutzer kann bis zu 3 Mal einen erneuten Versuch starten.

Nach 3 fehlgeschlagenen Versuchen wird dem Benutzer vorübergehend der Zugriff verweigert.

438103809 A43fda8d 86b8 40f8 9314 707e8c6b7c9c 1

3.Temporäre Sperrlogik

  • Benutzer, denen der Zugriff verweigert wurde, werden für 24 Stunden blockiert, bevor sie einen erneuten Versuch starten können

AgeChecker-Plugin – API-Dokumentation

Das AgeChecker Plugin für Shopware 6 ist eine leistungsstarke Lösung, die Händlern dabei hilft, die Altersverifikation auf ihren Online-Shops durchzusetzen. Durch die Integration mit einem zuverlässigen externen Altersprüfungsdienst stellt das Plugin sicher, dass Kunden die erforderlichen Altersanforderungen erfüllen, bevor sie Produkte einsehen oder einen Kauf abschliessen können.

Dieses Plugin ist besonders nützlich für Unternehmen, die altersbeschränkte Produkte wie Alkohol, Tabak oder Inhalte für Erwachsene verkaufen, da es eine zuverlässige und rechtlich konforme Schutzebene für Händler und Kunden bietet. AgeChecker ist flexibel konfigurierbar, sodass Shop-Betreiber den Verifizierungsprozess an ihre spezifischen Anforderungen anpassen können, ohne dass das Einkaufserlebnis darunter leidet.

Kunden-Altersverifizierungsstatus aktualisieren

Endpoint

POST /age-checker-user-status

Beschreibung

custom_age_confirmed_

Aktualisiert das Custom-Feld für einen angemeldeten Kunden basierend auf dem Altersverifizierungsergebnis, das vom AgeChecker.net-Service empfangen wurde.

Systemprüfungen

  • Der Kunde muss angemeldet sein.

  • Die UUID von AgeChecker.net muss bereitgestellt werden.

  • Die AgeChecker.net-API wird aufgerufen, um das Ergebnis zu verifizieren.

  • Das Custom-Feld

Request-Header 

sw-context-token:
Content-Type: application/json

Beispiel-Request-Body 

{
  "uuid": "8e7c35e2-3f48-4fc9-9283-fb0e198b0fd5"
}

Erfolgreiche Antwort 

{
  "message": "Customer age verification status updated"
}

Beispiel für eine Fehlerantwort 

{
  "message": "uuid is required"
}

Fehlerbehebung

Funktionalität überprüfen

  • Bestätigen Sie, dass das Popup im Checkout erscheint.

  • Testen Sie beide Verifizierungsmethoden.

  • Simulieren Sie 3 fehlgeschlagene Versuche, um zu bestätigen, dass der Benutzer danach blockiert wird.

FAQ

1. Ist ein API-Key erforderlich?
Ja. Ohne einen gültigen API-Key funktioniert die Altersverifikation nicht.

2. Kann ich es auf bestimmte Sales Channels beschränken?
Ja. Sie können das Plugin pro Sales Channel aktivieren oder deaktivieren.

3. Blockiert dieses Plugin den Checkout?
Ja, bis der Benutzer die Altersverifikation erfolgreich abgeschlossen hat.

4. Was passiert nach 3 fehlgeschlagenen Versuchen?
Der Benutzer wird auf eine temporäre Sperrseite weitergeleitet und kann erst nach Ablauf der Sperrfrist erneut versuchen, sich zu verifizieren.

5. Eignet sich AgeChecker für Shops in der Schweiz?
Ja, das Plugin lässt sich in jedem Shopware-6-Shop einsetzen. Welche Altersgrenzen für Ihre Produkte gelten, richtet sich nach dem Schweizer Recht; klären Sie das vor der Konfiguration. Bei der Einrichtung unterstützt Sie solution25, wir betreuen Händler in der Schweiz und in Deutschland.