Zum Inhalt springen
altersverifikation.ch

Integrationen

Passt zu eurem Shopsystem.

Für WooCommerce gibt es ein Plugin. Alle anderen Shops verbinden sich über die BCC-Adresse in der Bestellbestätigung, über einen Link oder über die API. Das Ergebnis ist überall dasselbe: «18+ bestätigt» pro Bestellung, ohne dass ihr Ausweisdaten seht.

Übersicht

Welcher Weg für welchen Shop.

  • WooCommerce

    Plugin

    Bestellungen werden automatisch zurückgehalten und freigegeben.

    Zum Plugin

  • Shopify

    BCC-Adresse

    BCC in der Benachrichtigung «Bestellbestätigung». Für den Link: Variable {{ order.name }}.

  • Shopware 6

    BCC-Adresse

    BCC in der Mailvorlage «Bestellbestätigung». Für den Link: Variable {{ order.orderNumber }}.

  • Wix, shopkit und andere

    BCC oder Link

    Jedes System, das eine Bestellbestätigung per Mail verschickt. Ohne BCC-Feld setzt ihr den Link in die Mailvorlage.

  • Eigener Shop

    API und Webhooks

    Prüfungen direkt aus eurem System anlegen, Ergebnis als signierter Webhook.

    Zur API

WooCommerce-Plugin

Prüfen, zurückhalten, freigeben. Automatisch.

Das Plugin legt für jede Bestellung mit Altersgrenze eine Prüfung an und hält sie zurück, bis das Ergebnis da ist. Statt BCC-Adresse braucht es nur einen API-Key.

  • Nach der Bestellung

    Bezahlte Bestellungen bleiben auf «Altersprüfung offen», bis das Alter bestätigt ist, und gehen danach automatisch auf «In Bearbeitung».

  • Oder vor dem Kauf

    Warenkorb und Kasse zeigen einen Hinweis. Bestellen geht erst, wenn das Alter bestätigt ist, im klassischen Checkout und im Block-Checkout.

  • Pro Produkt oder Kategorie

    Ab 16 oder ab 18 legt ihr beim Produkt oder bei der Produktkategorie fest. Bestellungen ohne solche Artikel laufen wie bisher.

  • Ohne Kopieren eingerichtet

    Ihr tragt nur den API-Key ein. Das Plugin richtet den signierten Webhook selbst ein und gleicht stündlich ab, falls einer nicht ankommt.

  • Für die Kundschaft sichtbar

    Button «Alter jetzt bestätigen» auf der Danke-Seite, in der Bestellmail und unter «Mein Konto». Storno bricht die Prüfung ab.

  • Deutsch, Französisch, Italienisch

    Texte für Shop und Kundschaft in allen drei Sprachen. Kompatibel mit den neuen Bestelltabellen (HPOS) von WooCommerce.

In vier Schritten eingerichtet

  1. 1

    Plugin herunterladen und in WordPress unter Plugins → Installieren → Plugin hochladen aktivieren.

  2. 2

    Im Dashboard von altersverifikation.ch unter Integration einen API-Key erzeugen.

  3. 3

    Den Key in WooCommerce → Einstellungen → Altersverifikation eintragen und speichern.

  4. 4

    Altersgrenze bei Produkten oder Kategorien setzen und mit eingeschaltetem Testmodus eine Bestellung aufgeben.

Voraussetzungen: WordPress ab 6.4, WooCommerce ab 8.2, PHP ab 7.4 und ein Konto bei altersverifikation.ch. Die Prüfung selbst läuft auf altersverifikation.ch; das Plugin überträgt Bestellnummer, E-Mail-Adresse, Name und Altersgrenze der betroffenen Bestellungen.

Für alle Shopsysteme

BCC-Adresse oder Link.

Ohne Plugin und ohne Entwicklung: Ihr tragt eure Eingangsadresse als BCC der Bestellbestätigung ein. Wir lesen Bestellnummer, E-Mail und Name aus der Mail und laden die Kundin oder den Kunden ein.

BCC, Link und API im Vergleich

BCC-Adresse

shop@in.altersverifikation.ch

Nur Mails von eurer hinterlegten Absenderdomain mit bestandener SPF/DKIM-Prüfung lösen eine Prüfung aus.

Link

altersverifikation.ch/c/<shop-id>?order={{order_number}}

Für die Mailvorlage oder den Warenkorb. Ohne Bestellnummer funktioniert er als Prüfung vor dem Kauf.

Für Entwicklerinnen und Entwickler

API und Webhooks.

Mit einem API-Key aus dem Dashboard legt ihr Prüfungen direkt an. Das Ergebnis kommt als Webhook, signiert mit HMAC-SHA256 im Header X-Altersverifikation-Signature.

  • POST /api/v1/checks

    Prüfung anlegen: Bestellnummer, E-Mail, Name, Schwelle 16 oder 18. Gleiche Bestellnummer, gleiche Prüfung.

  • GET /api/v1/checks/:id

    Stand einer Prüfung abfragen.

  • POST /api/v1/checks/:id/cancel

    Offene Prüfung abbrechen, zum Beispiel bei einem Storno.

  • POST /api/v1/checks mit precheck

    Prüfung vor dem Kauf: Antwort mit Link für die Kundin, Rücksprung in euren Shop.

  • PUT /api/v1/shop/webhook

    Webhook-URL setzen und Secret abholen, für Plugins, die sich selbst einrichten.

curl -X POST https://altersverifikation.ch/api/v1/checks \
  -H "Authorization: Bearer avk_…" \
  -H "content-type: application/json" \
  -d '{"orderNumber":"1001","email":"kunde@example.ch","name":"Max Muster","minAge":18}'

Ein Konto, jeder Weg.

Konto erstellen, Plan wählen und im Dashboard den passenden Weg für euren Shop einrichten.