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. Einrichtung Schritt für Schritt

Ab Plugin 1.14.0 ist die Plugin-Einstellung nach erfolgreichem Verbinden automatisch aktiviert. Unter Valyda → Übersicht führt dich eine Checkliste durch die Einrichtung. Erledigte Schritte werden markiert; die nächsten Eingaben stehen direkt auf dieser Seite.

  1. Konto verbinden und Altersprüfung aktivieren: nach dem Verbinden bereits erledigt. Wurde die Prüfung später deaktiviert, kannst du sie hier wieder einschalten.
  2. Alle Bestellungen oder einzelne Produkte: Auswahl direkt im Ablauf speichern.
  3. Produkte auswählen erscheint nur bei einzelnen Produkten. Der Link führt zur Produktübersicht. Markiere veröffentlichte Produkte mit Altersprüfung erforderlich – über QuickEdit, Mehrfachbearbeitung oder im Produkteditor. Beim Zurückkehren erkennt Valyda die Markierung automatisch.
  4. Mindestalter festlegen: üblicherweise 18+, bei Bedarf 16+. Für das gewählte Profil muss Valyda den passenden Workflow eingerichtet haben.
  5. Test- oder Live-Modus wählen: Sandbox-Prüfungen sind simuliert und kostenlos. Live-Prüfungen zählen zum Tarif. Ein fehlender Workflow oder eine fehlende Live-Konfiguration wird angezeigt.
  6. Abo aktivieren erscheint nur im Live-Modus. Registrierung und Shopverbindung allein starten keine Abo-Testphase. Der Testmodus funktioniert ohne Abo.
  7. Datenschutzerklärung prüfen: Links zur Anleitung und zur Datenschutzseite deines Shops stehen direkt im Schritt.
  8. Checkout testen: öffne Shop und Checkout über die angebotenen Links. Teste einen Warenkorb mit prüfpflichtigem Produkt und bei produktbezogener Prüfung auch einen ohne. Bestätige anschliessend selbst, dass du den Checkout getestet hast.

Du kannst erledigte Schritte wieder öffnen und die Auswahl ändern. Änderungen am Prüfmodus, Mindestalter, Geltungsbereich oder an Produktmarkierungen machen die Checkout-Testbestätigung erneut erforderlich. Die Meldung am Ende unterscheidet zwischen Testeinrichtung und Live-Betrieb. Design und Texte lassen sich optional weiterhin in den Einstellungen anpassen.

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

Feld Inhalt
_valyda_verified Prüfung bestanden
_valyda_verified_at Zeitstempel
_valyda_profile Verwendetes Prüfprofil
_valyda_verification_id Referenz für Rückfragen

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

Hook Zweck
valyda_cart_requires_check Eigene Regeln, wann geprüft wird
valyda_required_profile Prüfprofil je Warenkorb bestimmen
valyda_api_base Abweichender Endpunkt, etwa für Staging

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.

Testmodus und Live-Prüfungen

In Valyda → Übersicht lässt sich Testmodus aktivieren oder deaktivieren; dieselbe Auswahl steht unter Einstellungen → Allgemein.

  • Aktiviert: Didit-Sandbox mit simulierten Ergebnissen. Keine Prüfkosten, kein Verbrauch des Test- oder Abo-Kontingents und kein Abo nötig. Checkout und Bestellungen zeigen einen Testhinweis.
  • Deaktiviert: echte Didit-Prüfungen. Eine abgeschlossene Prüfung zählt einmal zum Tarif; enthaltene Prüfungen und Mehrverbrauch richten sich nach dem Abo. Wiederholte Statusabfragen zählen nicht zusätzlich.

Testresultate gelten nicht im Live-Modus. Nach dem Wechsel ist eine neue Prüfung erforderlich. Fehlt die Live-Konfiguration bei Valyda, zeigt das Plugin einen Hinweis und startet keine Prüfung. Die Shop-Verbindung bleibt beim Umschalten bestehen.