Altersverifikation

Alter verifizieren.

Der Nutzer öffnet die MiniApp und erhält einen kurzen Code. Gib ihn hier ein — der Nutzer bestätigt in der App, du bekommst das verifizierte Alter zurück. Kein Onboarding, keine Ausweisdaten.

Nutzer öffnet die MiniApp und sieht einen Code.

Code hier eingeben und verifizieren.

Nutzer bestätigt mit „Ja" in der App.

Du erhältst das bestätigte Alter.

Verifikations-Code *

4–8 Zeichen, wie in der MiniApp angezeigt.

Der Nutzer sieht in der MiniApp: …

API-Dokumentation

Du kannst die Altersverifikation auch direkt server-zu-server integrieren. Zwei Endpoints, ein API-Key, kein Onboarding.

Zugangsdaten

Base URL…

API-Key · Header X-API-Key…

POST/api/v1/verify

Sende den Code, den der Nutzer in der MiniApp sieht. Die Antwort kommt sofort mit einer requestId; das tatsächliche Ergebnis holst du per Polling am zweiten Endpoint.

Request Body

Feld	Typ	Beschreibung
`code` *	string	4–8 Zeichen, alphanumerisch — wie in der MiniApp angezeigt.
`partnerName` *	string	Wird dem Nutzer in der MiniApp angezeigt.
`expectedName`	string	Optional. Aktiviert den Name-Match-Modus.

Beispiel

# Code verifizieren
curl -X POST https://altersbestatigung.temmuz.uk/api/v1/verify \
  -H "X-API-Key: <DEIN_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"code":"ABCDE","partnerName":"shop.de"}'

Antwort · 200

{
  "requestId": "T6w64F8gpKYBEBvrvYjGb4YJiG5yki5p",
  "status": "pending",
  "expiresAt": 1778246397189
}

Fehler

Code	Bedeutung
`401`	invalid_api_key — Key fehlt oder ungültig.
`400`	invalid_body — Body unvollständig oder fehlerhaft.
`404`	code_not_found — Code unbekannt.
`410`	code_expired — Code abgelaufen.
`409`	code_not_available — Code gerade nicht verfügbar.

GET/api/v1/verify/{requestId}

Polle alle 1–2 Sekunden, bis status nicht mehr pending ist. Bei confirmed bekommst du das Alter zurück.

Beispiel

curl https://altersbestatigung.temmuz.uk/api/v1/verify/<requestId> \
  -H "X-API-Key: <DEIN_API_KEY>"

Antwort · bestätigt

{
  "requestId": "T6w64F8…",
  "status": "confirmed",
  "age": 36
}

Mögliche Status

confirmed + age pending rejected expired name_mismatch

Es werden keine Ausweisdaten übertragen. Du erhältst ausschließlich das bestätigte Alter (bzw. eine Ja/Nein-Antwort beim Name-Match). In dieser Demo-Umgebung sind Base URL und API-Key zu Testzwecken offen einsehbar.