WooCommerce

Stand: 18. August 2026

Die Einrichtung benötigt keinen eigenen Code. Das Plugin heisst Valyda Age Verification und setzt WordPress 6.4, PHP 8.1 und WooCommerce voraus.

1. Plugin installieren

Lade das aktuelle Plugin als ZIP herunter. Öffne in WordPress Plugins → Installieren → Plugin hochladen, wähle die ZIP-Datei und aktiviere das Plugin. Im Menü erscheint Valyda Verifikation. Für die direkte Kontoverbindung benötigt dein Shop HTTPS und Plugin-Version 1.13.0 oder neuer.

2. Mit Valyda verbinden

Klicke im Plugin auf Mit Valyda verbinden. Die Anmeldung öffnet sich in einem neuen Tab. Melde dich bei Valyda an, beispielsweise mit Google, oder erstelle ein Konto. Prüfe die angezeigte Shopadresse und bestätige Shop verbinden. Danach schliesst sich der Anmelde-Tab und die Plugin-Seite aktualisiert sich automatisch (ab Version 1.13.1). Einen API-Schlüssel musst du weder kopieren noch eingeben.

Unter Verbundene Shops im Kundenkonto kannst du den Zugriff wieder entfernen. Auch im Plugin lässt sich die Verbindung trennen; dein Abo wird dadurch nicht gekündigt. Die manuelle Einrichtung bleibt unter Erweitert: manuell mit API-Schlüssel verbinden verfügbar.

3. Abo wählen und Verbindung testen

Wähle im Kundenkonto dein erstes Abo, um die einmalige Testphase mit 14 Tagen und zehn Ausweisprüfungen zu starten. Die Registrierung und Shopverbindung allein starten noch keine Frist. Aktualisiere anschliessend den Abo-Status im Plugin.

Prüfe die Verbindung mit Testverifikation starten in der Vorschau. Die Ausweisprüfung öffnet das aktuelle Widget; eine E-ID ist dafür nicht erforderlich. Dieser Test erzeugt eine echte Verifikation. Abgeschlossene Ausweisprüfungen zählen zum Kontingent deines Kontos, auch bei negativem Ergebnis.

4. Festlegen, wann geprüft wird

Unter Einstellungen → Prüfprofile:

• Nur markierte Produkte – geprüft wird, sobald ein entsprechendes Produkt im Warenkorb liegt. Markiere es im Produkt unter „Allgemein" mit Altersprüfung erforderlich.
• Alle Bestellungen – jede Bestellung erfordert eine Prüfung.

Dazu wählst du das Prüfprofil, üblicherweise 18+. Aktiviere danach die Altersprüfung in den Plugin-Einstellungen. Das Verbinden allein schaltet die Prüfung an der Kasse noch nicht ein.

5. Testbestellung

Markiertes Produkt in den Warenkorb, zur Kasse. Der Kasten Altersprüfung erscheint, der Bestellknopf bleibt gesperrt, bis die Prüfung bestätigt ist.

Beide Kassen sind gesperrt

WooCommerce liefert zwei Kassen aus, die sich keinen Code teilen. Die klassische Kasse durchläuft woocommerce_checkout_process; die Block-Kasse legt Bestellungen über die Store-API an und ruft diesen Hook nie auf.

Ein Plugin, das nur den klassischen Hook kennt, lässt über die Block-Kasse ungeprüfte Bestellungen durch, ohne dass jemand etwas merkt. Dieses Plugin sperrt beide serverseitig, und beide Wege sind einzeln getestet – auch der Versuch, die Oberfläche zu umgehen und direkt gegen die Store-API zu bestellen. Er endet mit HTTP 400 und ohne Bestellung.

Dem Browser wird dabei nicht geglaubt: Bevor eine Bestellung entsteht, fragt PHP das Ergebnis selbst bei der API ab. Das Widget steuert nur die Anzeige.

Was an der Bestellung gespeichert wird

Bei der externen Ausweisprüfung erhält dein Shop keine Ausweiskopie. Die Dokumentenprüfung findet beim Prüfdienst statt. Falls du die optionale manuelle Prüfung aktivierst, kontrollierst du den hochgeladenen Ausweis selbst.

Sprachen

Das Plugin bringt Kataloge für de_CH, de_DE, fr_CH, fr_FR, it_CH und it_IT mit und richtet sich nach der Sprache der Website.

Für Entwicklerinnen

Damit lässt sich zum Beispiel nach Versandland unterscheiden oder für einen bestimmten Warenkorb von 18+ auf 16+ wechseln.

Wenn etwas nicht funktioniert

Aktiviere unter Einstellungen → Erweitert den Debug-Modus. Die Meldungen erscheinen unter WooCommerce → Status → Logs; Ausweisdaten werden dabei nicht protokolliert. Schick den Auszug bei Bedarf an support@valyda.ch.