Altersverifizierungs-API für Websites & Apps
Prüfen Sie, ob ein Besucher Ihre Altersgrenze erfüllt – ohne dass Ihre Anwendung Ausweisdokumente oder Geburtsdaten speichert.
Prüfen, ob ein Besucher Ihre Altersgrenze erfüllt
Eine Sitzung erledigt beide Hälften: Der Besucher weist per WhatsApp die Kontrolle über seine Telefonnummer nach, beantwortet die Altersfrage einmal, und Ihre Anwendung erhält das Ergebnis – erfüllt oder nicht erfüllt, gemessen an der von Ihnen festgelegten Altersgrenze.
So funktioniert die Altersverifizierung
Schritt eins: das Telefon verifizieren. Sie rufen POST /start-verification mit flow=age auf und zeigen den zurückgegebenen WhatsApp-Deep-Link auf dem Desktop als QR-Code und auf dem Smartphone als Schaltfläche an. Der Besucher sendet eine vorausgefüllte Nachricht aus seinem eigenen WhatsApp-Account, sodass die Kontrolle über die Nummer durch das Senden belegt wird und nicht durch einen Code, den Sie an sie geschickt haben.
Schritt zwei: die Altersgrenze festlegen. Derselbe Aufruf akzeptiert ein optionales min_age. Lassen Sie es weg, gilt die in Ihrem Konto konfigurierte Altersgrenze – 18, sofern Sie sie nicht geändert haben. min_age wird nur bei flow=age akzeptiert und muss eine positive ganze Zahl sein; alles andere kommt als 400 zurück.
Schritt drei: den Alterscheck abschließen. Sobald die Telefonhälfte nachgewiesen ist, enthält die Antwort einen age-Block mit dem Status pending und einer age_verification_url. Derselbe einmalige Link wird dem Besucher über WhatsApp gesendet, und Sie können ihn nutzen, um den Besucher in dem Browser weiterzuführen, in dem er bereits ist. Er antwortet beim Altersanbieter und landet dann wieder auf Ihrer callback_url, an die token und age=verified, denied oder failed angehängt sind.
Schritt vier: das Ergebnis empfangen. Ein zweiter Webhook, age_verification_result, wird ausgelöst, sobald der Anbieter antwortet, und GET /check-verification-status meldet dasselbe. Der age-Block enthält status, verified, required – die tatsächlich geprüfte Altersgrenze –, verified_at und provider.
Eine Falle sollten Sie kennen, bevor Sie die Polling-Schleife schreiben. Der Status der Sitzung selbst erreicht verified, sobald die Telefonnummer nachgewiesen ist, während age.status noch pending ist. Betrachten Sie den age-Block als das Signal für den Altersschritt, niemals den Sitzungsstatus.
Telefonverifizierung + Altersverifizierung
Die beiden Schritte beantworten zwei verschiedene Fragen, und der Ablauf hält sie bewusst auseinander. Das Senden einer WhatsApp-Nachricht belegt, dass der Besucher diese Nummer kontrolliert. Über sein Alter sagt es überhaupt nichts: Eine Telefonnummer ist kein Altersnachweis, und kein Teil dieses Ablaufs behandelt sie als solchen.
Was der Telefonschritt Ihnen bringt, ist ein Ort für die Antwort. Ein Alterergebnis allein ist eine lose Tatsache – irgendjemand hat irgendwo eine Altersgrenze erreicht. Gebunden an eine Nummer, die der Besucher gerade nachweislich benutzt hat, wird es zu etwas, das Sie beim nächsten Besuch wiedererkennen können.
Das macht auch den wiederkehrenden Besucher günstig. Ein bestandenes Ergebnis wird ein Jahr lang zur Telefonnummer gespeichert, sodass jemand, der dieselbe Altersgrenze bereits erreicht hat, die Nummer erneut nachweist und die frühere Antwort mitnimmt, statt wieder zum Anbieter geschickt zu werden. Endet die WhatsApp-Nachricht mit #reset, wird der Cache übersprungen, wenn Sie eine frische Antwort brauchen.
Alter verifizieren, ohne eine Identitätsdatenbank aufzubauen
Die Frage, die eine Alterssperre stellt, ist ein Boolean. Der Großteil der üblicherweise erhobenen Daten zu ihrer Beantwortung ist es nicht, und genau deshalb ist ein Dokumentenarchiv ein so schlechter Tausch: Sie halten am Ende Reisepässe und Führerscheine vor, um ein Ja zu speichern.
Was Ihre Anwendung braucht, ist wenig. Das Ergebnis – verified, denied, failed oder noch pending. Die geprüfte Altersgrenze. Wann geantwortet wurde und welcher Anbieter geantwortet hat. Die Sitzungskennung und die verifizierte Telefonnummer, die die Antwort an den Besucher vor Ihnen binden. Das ist der gesamte age-Block plus das, was der Telefonablauf ohnehin zurückgibt.
Was Ihre Anwendung nicht braucht, sind ein Geburtsdatum oder ein Ausweisdokument, und die API liefert keines von beidem, sodass es kein Feld gibt, das versehentlich protokolliert werden könnte. Eine bestandene Antwort wird zur Telefonnummer als Antwort, Altersgrenze und Datum gespeichert. Die Zugangsdaten des Anbieters liegen in serverseitigen Secrets, und was der Anbieter für seine Entscheidung prüfen musste, wird nicht an Sie weitergegeben.
Nichts davon ist eine Aussage über Ihre eigenen Pflichten. Was Sie prüfen müssen, wie lange Sie die Prüfung nachweisen können müssen und was als zulässige Methode gilt, sind Fragen für Ihre Rechtsberatung und Ihre Aufsichtsbehörde, nicht für einen API-Anbieter.
Altersverifizierung vs. Identitätsverifizierung
Die Altersverifizierung beantwortet eine Frage: Erfüllt dieser Besucher die von Ihnen festgelegte Altersgrenze? Die Identitätsverifizierung beantwortet eine andere: Wer ist diese Person? Beides wird oft zusammen verkauft, und beides bewegt sehr unterschiedliche Datenmengen.
flow=age gehört zur ersten Art. Es liefert keinen Namen, kein Geburtsdatum und nichts aus einem Dokument. Es ist kein KYC, und ein bestandenes Ergebnis ist keine Identitätsaussage, auf die Sie sich anderswo stützen können. Wenn Ihre Pflicht darin besteht zu wissen, wer ein Kunde ist, ist dies nicht das Werkzeug für diesen Teil.
Es erbt außerdem die Annahme, die jeder telefonbasierten Prüfung zugrunde liegt: dass die Nummer der Person gehört, die sie benutzt. Die Kontrolle durch das Senden einer Nachricht zu belegen, ist verlässlicher als der Empfang einer SMS, doch ein Jugendlicher mit Zugriff auf das Telefon eines Erwachsenen ist ein Szenario, das keine Fernprüfung vollständig schließt. Der unten verlinkte Artikel über Alterschecks, die nicht zu einer Ausweisdatenbank werden, geht ausführlicher auf die Architektur, die vier Zustände und die Grenzen ein.
Altersverifizierung in Ihre App integrieren
Es sind dieselben zwei REST-Aufrufe, die jede Phone-Verif-Integration nutzt, mit einem geänderten Parameter. Authentifizieren Sie sich mit Ihrem API-Schlüssel im Header x-api-key, öffnen Sie die Sitzung mit flow=age und lesen Sie den age-Block über den Status-Endpunkt oder den Webhook aus.
- Besucher
- Telefonverifizierung per WhatsApp
- Alterscheck beim Anbieter
- Alterergebnis
- Ihre Anwendung
Die beiden Schritte beantworten zwei verschiedene Fragen und bleiben durchgehend getrennt. Das Senden der WhatsApp-Nachricht belegt, dass der Besucher diese Nummer kontrolliert; es gilt nie als Beleg für sein Alter. Der Altersschritt liefert das Alterergebnis.
curl -X POST "https://api.phone-verif.com/start-verification?flow=age&min_age=18" \
-H "x-api-key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"session_id": "checkout-4821", "callback_url": "https://your-app.example/age-checked"}'Öffnen Sie eine Sitzung mit flow=age. Lassen Sie min_age weg, gilt die in Ihrem Konto konfigurierte Altersgrenze – 18, sofern Sie sie nicht geändert haben.
{
"status": "verified",
"age": { "status": "pending", "verified": false, "required": 18 },
"age_verification_url": "https://t.phone-verif.com/av/AbCd1234"
}Die Sitzung erreicht verified, sobald die Telefonnummer nachgewiesen ist, während der Altersschritt noch aussteht. Lesen Sie für die Altersantwort age.status, nicht den Sitzungsstatus – und leiten Sie den Besucher zu age_verification_url, damit er die Prüfung in dem Browser abschließt, in dem er bereits ist.
{
"event": "age_verification_result",
"session_id": "checkout-4821",
"validation_token": "...",
"age": {
"status": "verified",
"verified": true,
"required": 18,
"verified_at": "2026-09-01T22:00:00.000Z",
"provider": "ageverif"
}
}Sobald der Anbieter antwortet, überträgt ein zweiter Webhook das Ergebnis, und der Status-Endpunkt meldet denselben Block.
flow=age erfordert einen in Ihrem Konto konfigurierten Altersanbieter. Wird es ohne einen angefordert, antwortet die API mit 503 und dem Code age_not_configured, sodass eine Fehlkonfiguration von einem Ausfall unterscheidbar ist.
FAQ zur Altersverifizierung
- Kann ich prüfen, ob Nutzer über 18 sind?
- Ja. Öffnen Sie die Sitzung mit flow=age und lassen Sie min_age weg: Der Ablauf prüft dann gegen die in Ihrem Konto konfigurierte Altersgrenze, die 18 beträgt, sofern Sie sie nicht in Ihren Einstellungen geändert haben.
- Kann ich ein anderes Mindestalter verwenden?
- Ja. Übergeben Sie min_age beim Start-Aufruf mit der gewünschten Altersgrenze. Es muss eine positive ganze Zahl sein, wird nur bei flow=age akzeptiert, und alles andere wird mit 400 abgelehnt. Jede Sitzung behält die Altersgrenze, mit der sie geöffnet wurde, und diese kommt als required im age-Block zurück, sodass ein späterer Leser weiß, was tatsächlich festgestellt wurde.
- Muss ich das Geburtsdatum des Nutzers speichern?
- Nein, und Sie könnten es auch nicht, selbst wenn Sie wollten: Die API liefert keines zurück. Zurück kommt, ob die Altersgrenze erfüllt wurde, wie hoch sie war, wann geantwortet wurde und welcher Anbieter geantwortet hat.
- Muss ich Ausweisdokumente speichern?
- Nein. Der Anbieter muss unter Umständen ein Dokument einsehen, um seine Antwort zu bilden; Ihre Anwendung erhält immer nur die Antwort. Nichts aus dem Dokument wird von der API zurückgegeben, es gibt also nichts zu speichern.
- Belegt die Altersverifizierung die Identität einer Person?
- Nein. flow=age beantwortet, ob die Person, die eine nachgewiesene Telefonnummer hält, eine Altersgrenze erfüllt. Es ist keine Identitätsverifizierung und kein KYC: kein Name, kein Geburtsdatum, kein Dokument.
- Was passiert, wenn die Altersverifizierung fehlschlägt?
- denied und failed sind verschiedene Ergebnisse und sollten nicht zu einem zusammengefasst werden. denied ist eine Entscheidung des Anbieters, und eine Wiederholung ändert die Antwort nicht. failed bedeutet, dass der Anbieter nicht erreicht werden konnte, es wurde also nichts entschieden, und ein erneuter Versuch ist angemessen. Eine Ablehnung oder ein Anbieterfehler wird nicht berechnet; ein abgeschlossener Alterscheck wird als zweite Einheit zusätzlich zur Telefonverifizierung berechnet.
- Kann ich Telefonverifizierung und Altersverifizierung kombinieren?
- Genau das ist flow=age. Eine Sitzung weist die Telefonnummer per WhatsApp nach und führt dann den Altersschritt aus, und beide Ergebnisse kommen in derselben Sitzung an. Sie betreiben keine zwei Integrationen und gleichen keine zwei Kennungen ab.
- Kann ich für einen wiederkehrenden Besucher eine neue Prüfung erzwingen?
- Ja. Ein bestandenes Ergebnis wird ein Jahr lang für dieselbe Telefonnummer und dieselbe Altersgrenze wiederverwendet. Endet die WhatsApp-Verifizierungsnachricht mit #reset, wird die gespeicherte Antwort übersprungen, und der Besucher durchläuft die vollständige Prüfung erneut.
Related
Anwendungsfälle der Altersverifizierung
Inhalte für Erwachsene
Wo ein selbst gesetzter Haken nicht mehr als Prüfung gilt. Das Alterergebnis steuert den Zugang, bevor irgendetwas ausgeliefert wird, und der Besucher muss kein Dokument bei Ihnen hochladen.
Online-Glücksspiel
Wett- und Casino-Konten, die Minderjährige fernhalten müssen. Die Prüfung passt zur Registrierung und, wenn Ihre eigenen Regeln es verlangen, erneut vor einer sensiblen Aktion.
Alkohol und altersbeschränkte Waren
Getränke, Tabak, Vapes, Messer, Lösungsmittel und Feuerwerk. Die Prüfung sitzt vor dem Checkout, an der Bestellung statt an der Browsing-Sitzung.
Gaming
Altersfreigegebene Titel, Chat-Funktionen und kostenpflichtige Mechaniken, die unterhalb eines bestimmten Alters beschränkt sind. Die Altersgrenze ist ein Request-Parameter, sodass verschiedene Funktionen unterschiedliche anfordern können.
Marktplätze
Angebote, die gesetzlich oder durch Ihre eigene Richtlinie beschränkt sind. Käufer und Verkäufer lassen sich an unterschiedliche Altersgrenzen binden, indem die Sitzung mit einem anderen min_age geöffnet wird.
Soziale Netzwerke und Community-Plattformen
Mindestalter-Regeln für Konten, Direktnachrichten oder Live-Funktionen. Die Antwort ist an eine nachgewiesene Telefonnummer gebunden und überdauert so das Ende der Sitzung.
Build your altersverifizierung flow today
Start integrating in minutes with clear documentation, SDKs, and global message delivery.