Selfie-Checks hinzufügen

Dokumentenprüfungen bieten zwar Schutz vor der Verwendung betrügerischer Ausweisdokumente, doch Betrüger/innen können sich Zugang zu gestohlenen echten Dokumenten verschaffen. Um dies zu verhindern, kann Stripe Ihre Nutzer/innen Selfie-Prüfungen unterziehen.

Selfie-Prüfungen suchen im Lichtbildausweis und einer Gesichtsaufnahme des Nutzers/der Nutzerin nach charakteristischen biologischen Merkmalen, wie der Gesichtsgeometrie. Anschließend prüft Stripe mithilfe moderner Machine-Learning-Algorithmen, ob die Gesichtsaufnahmen zu derselben Person gehören.

Befolgen Sie zunächst den Leitfaden zum Erfassen und Verifizieren von Identitätsdokumenten, um Selfie-Prüfungen in Ihre Anwendung aufzunehmen.

Selfie-Prüfungen zu VerificationSessions hinzufügen

Verwenden Sie beim Erstellen einer VerificationSession den Parameter options.document.require_matching_selfie, um Selfie-Prüfungen zu ermöglichen.

curl https://api.stripe.com/v1/identity/verification_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=document \
  -d "options[document][require_matching_selfie]"=true

Dadurch wird der Verifizierungsablauf so konfiguriert, dass ein Lichtbildausweis und eine Gesichtsaufnahme Ihres Nutzers/Ihrer Nutzerin erforderlich sind.

Zugriff auf Ergebnisse der Selfie-Prüfung

Nachdem sie übermittelt und verarbeitet wurde, ändert sich der Status der VerificationSession je nach Ergebnis der Prüfungen:

• verified – Sowohl die Dokument- als auch die Selfie-Prüfung waren erfolgreich. Die Sitzung verified_outputs enthält aus dem Dokument entnommene Informationen.
• requires_input – Mindestens eine der Dokument- oder Selfie-Prüfungen ist fehlgeschlagen.

Um auf die erfassten Selfie- und Dokumentaufnahmen zugreifen zu können, müssen Sie den verknüpften VerificationReport abrufen. Dies können Sie tun, indem Sie das Feld last_verification_report in der Sitzung erweitern:

// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')(
'sk_test_BQokikJOvBiI2HlWgH4olfQ2');
const verificationSession = await stripe.identity.verificationSessions.retrieve(
  '{{SESSION_ID}}',
  {
    expand: ['last_verification_report'],
  }
);
const verificationReport = verificationSession.last_verification_report;

Im VerificationReport finden Sie die Felder Dokument und Selfie, die die Ergebnisse der Dokument- und Selfieprüfungen enthalten. Nachfolgend finden Sie ein Beispiel für einen VerificationReport mit erfolgreichen Dokumenten- und Selfie-Prüfungen.

{
  "id": "vr_BSyjRssHIe8HBW7CmF9IGwFd",
  "object": "identity.verification_report",
  "type": "document",
  "verification_session": "vs_mRM7Ww6o23xEkJ2EGpguH2jB",
  "created": 1611776872,
  "livemode": true,
  "options": {
    "document": {
      "require_matching_selfie": true
    }
  },
  "document": {
    "status": "verified",
    "error": null,
    "first_name": "Jenny",
    "last_name": "Rosen",
    "address": {
      "line1": "1234 Main St.",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94111",
      "country": "US"
    },
    "document_type": "id_card",
    "expiration_date": {
      "day": 17,
      "month": 7,
      "year": 2024
    },
    "files": ["file_Z2EyvjoF8shlHYJOMDSyH5zr", "file_OicGWaBPxdZLeC12hCcqy8DQ"],
    "issued_date": {
      "day": 4,
      "month": 27,
      "year": 2021
    },
    "issuing_country": "US"
  },
  "selfie": {
    "status": "verified",
    "error": null,
    "document": "file_n0SlLzSty4EbgR0nYJfyvdZf",
    "selfie": "file_itArye6bghpXStHWZNhCU6Xo",
  }
}

Um auf die erfassten Dokument- und Gesichtsaufnahmen zuzugreifen, lesen Sie bitte Zugriff auf Verifizierungsergebnisse.

Informationen zu fehlgeschlagenen Selfie-Prüfungen

Die VerificationReport-Felder Dokument und Selfie enthalten die gesammelten Daten sowie die Felder status und error, die erläutern, ob eine Prüfung erfolgreich war oder nicht.

Das status-Feld informiert Sie darüber, ob eine Prüfung erfolgreich war oder nicht. Folgende Werte sind möglich:

• verified – Die Verifizierungsprüfung war erfolgreich und die gesammelten Daten wurden verifiziert.
• unverified – Die Verifizierungsprüfung ist fehlgeschlagen. Im error-Hash finden Sie weitere Informationen.

Wenn die Verifizierungsprüfung fehlschlägt, enthält das error-Feld die Werte code und reason, die den Grund für das Fehlschlagen der Prüfung erläutern. Mit dem Feld error.code können Verifizierungsfehler programmatisch gehandhabt werden. Das Feld reason enthält eine beschreibende Nachricht, die den Grund für das Fehlschlagen erklärt und die Sie Ihrem/Ihrer Nutzer/in vorlegen können.

Fehlgeschlagene Dokumentprüfungen

Fehlerdetails sind im Berichtsfeld document.error verfügbar.

Fehlgeschlagene Selfie-Prüfungen

Fehlerdetails sind im Berichtsfeld selfie.error verfügbar.