Schnellstart

Das Prinzip

Sigillo prüft das Alter Ihrer Kundschaft mit der Schweizer e-ID. Ihr Shop-Server startet eine Prüfung, der Browser zeigt sie mit dem Sigillo-Widget an, und vor der Bestellung kontrolliert Ihr Server das Ergebnis.

Basis-URL	https://api.sigillo-id.ch/v1
Authentifizierung	Authorization: Bearer <API-Key>
Format	JSON
Interaktive Referenz	api.sigillo-id.ch/docs

Ihr API-Key gehört ausschliesslich auf Ihren Server – niemals in JavaScript, das im Browser läuft.

1. API-Key erhalten

Den Key erhalten Sie beim Onboarding von uns. Er beginnt mit sk_live_ und wird nur einmal angezeigt. Kontakt aufnehmen

2. Prüfung starten

curl -X POST https://api.sigillo-id.ch/v1/verifications \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"min_age": 18, "reference": "order-1042"}'

Die Antwort enthält unter anderem id, client_secret (für das Widget), deeplink und qr_svg. Eine Prüfung ist 15 Minuten gültig.

3. Ergebnis abfragen

curl https://api.sigillo-id.ch/v1/verifications/<id> \
  -H "Authorization: Bearer sk_live_…"

status ist pending, verified, rejected oder expired. Nehmen Sie die Bestellung nur an, wenn status gleich verified ist – und verwenden Sie jede Prüfung nur für eine Bestellung.

Weiter

• Sigillo-Widget einbinden
• Webhooks statt Abfragen