So verwenden Sie Persona

Dieser Artikel erklärt, wie Sie B2CORE für die Verwendung des KYC-Anbieters Persona konfigurieren. Mit Persona verifizieren Kunden ihre Identität im Persona-Ablauf, der in der B2CORE UI oder der mobilen App geöffnet wird: Sie erfassen ein amtliches Ausweisdokument und ein Selfie, die Persona anschließend prüft. B2CORE empfängt das Ergebnis, lädt die Dokumentfotos in das Kundenprofil herunter, aktualisiert die Kundendaten und genehmigt oder lehnt den Verifizierungsantrag ab.

So funktioniert die Verifizierung

1. Ein Kunde startet die Verifizierung für eine Stufe, die Persona verwendet. B2CORE erstellt eine Persona-Inquiry anhand der dieser Stufe zugewiesenen Inquiry-Vorlage und trägt den Namen, die E-Mail-Adresse und die Telefonnummer des Kunden vorab ein.
2. Der Persona-Ablauf wird in der B2CORE UI oder der mobilen App geöffnet. Der Kunde lädt Dokumente hoch und nimmt direkt in Persona ein Selfie auf – die Dateien werden nicht über B2CORE übertragen.
3. Nachdem der Kunde den Ablauf abgeschlossen hat, erstellt B2CORE einen Verifizierungsantrag für die Stufe.
4. Persona entscheidet über die Inquiry (automatisch über einen Persona-Workflow oder manuell durch Ihr Compliance-Team) und sendet einen Webhook an B2CORE.
5. B2CORE lädt die Dokumentfotos herunter, aktualisiert das Kundenprofil und genehmigt oder lehnt den Antrag ab. Wird der Antrag genehmigt, erhält der Kunde die Verifizierungsstufe.

Wenn der Kunde den Browser oder die App schließt, bevor der Ablauf zu B2CORE zurückkehrt, schließt der Webhook den Antrag trotzdem ab. Es gehen also keine Daten verloren.

Persona einrichten

Führen Sie die folgenden Schritte im Persona-Dashboard aus. Die dabei erhaltenen Werte benötigen Sie, um die Verbindung in B2CORE zu konfigurieren.

Inquiry-Vorlagen erstellen

Erstellen Sie für jede B2CORE-Verifizierungsstufe, die Persona verwenden soll, eine Inquiry-Vorlage. Fügen Sie die für die Stufe erforderlichen Verifizierungsschritte hinzu, beispielsweise ein amtliches Ausweisdokument und ein Selfie. Optional können Sie eine separate Vorlage für Firmenkunden erstellen.

Kopieren Sie die ID jeder Vorlage (sie beginnt mit itmpl_). Sie finden sie in den Vorlageneinstellungen im Persona-Dashboard.

Entscheidungsfindung einrichten

Erstellen Sie einen Persona-Workflow, der Inquiries genehmigt, die alle Prüfungen bestehen, und solche ablehnt, die Prüfungen nicht bestehen. Ohne einen solchen Workflow bleiben Inquiries in Persona im Status completed oder failed und werden nie genehmigt oder abgelehnt.

API-Schlüssel abrufen

Erstellen Sie im Persona-Dashboard einen API-Schlüssel. Sandbox-Schlüssel beginnen mit persona_sandbox_, Produktionsschlüssel mit persona_production_. Die API-URL ist für beide Umgebungen gleich; der Schlüssel bestimmt, welche Umgebung verwendet wird.

Umgebungs-ID abrufen

Kopieren Sie die ID der verwendeten Persona-Umgebung (sie beginnt mit env_). Sie finden sie im Persona-Dashboard unter Organisation > Informationen.

Webhook erstellen

Erstellen Sie im Persona-Dashboard einen Webhook mit den folgenden Einstellungen:

• URL: https://{your-B2CORE-back-office-domain}/api/v2/my/verification-persona/webhook
• Ereignisse:
  • inquiry.created
  • inquiry.completed
  • inquiry.failed
  • inquiry.approved
  • inquiry.declined
  • inquiry.marked-for-review

Kopieren Sie nach dem Erstellen des Webhooks dessen Geheimnis (es beginnt mit wbhsec_).

So konfigurieren Sie eine Verbindung zu Persona

Nur Administratoren mit den Berechtigungen zum Verwalten externer Verbindungen können eine Verbindung zu Persona einrichten.

So richten Sie eine Verbindung ein:

Verbindungseinstellungen

Wenn Sie die Verbindung später bearbeiten, lassen Sie die Felder API-Schlüssel und Webhook-Geheimnis leer, damit die gespeicherten Werte erhalten bleiben.

Abgeschlossene Prüfungen ohne Persona-Entscheidung genehmigen

• No (empfohlen) — B2CORE wartet, bis Persona die Inquiry genehmigt oder ablehnt.
• Yes — eine vom Kunden abgeschlossene Inquiry wird genehmigt und eine fehlgeschlagene Inquiry wird abgelehnt, ohne auf eine Entscheidung von Persona zu warten.

Präfix der Referenz-ID

Persona behandelt eine Referenz-ID als eine Person. B2CORE sendet die Kunden-ID als Referenz-ID. Mit dem Präfix brand- wird beispielsweise der Kunde mit der ID 454 als brand-454 gesendet.

• Wenn mehrere B2CORE-Installationen dieselbe Persona-Organisation verwenden (beispielsweise die Produktionsumgebung und eine Testumgebung oder zwei Marken), weisen Sie jeder Installation ein eindeutiges Präfix zu. Andernfalls werden verschiedene Kunden mit derselben ID in Persona zu einer Person zusammengeführt.
• Wenn Ihre Persona-Organisation nur von dieser B2CORE-Installation verwendet wird, lassen Sie das Feld leer. B2CORE sendet dann die Kunden-ID ohne Präfix.
• Das Präfix darf bis zu 32 Zeichen lang sein und lateinische Buchstaben, Ziffern sowie die Zeichen _, ., :, - enthalten.

Selfies synchronisieren

• Yes (Standard) — das Selfie, das der Kunde in Persona aufgenommen hat, wird zusammen mit den Ausweisfotos in den Dokumenten des Kunden gespeichert.
• No — nur die Ausweisfotos werden gespeichert. Das Selfie verbleibt in Persona.

So erstellen Sie Verifizierungsstufen für Persona

Sie können Verifizierungsstufen erstellen oder bestehende Stufen so ändern, dass sie Persona für die Verifizierung verwenden.

So erstellen Sie eine Verifizierungsstufe:

Dokumentgruppen und Dokumenttypen sind für Persona nicht erforderlich: Die Dokumente, die Kunden einreichen müssen, werden in der Persona-Inquiry-Vorlage festgelegt.

Stufen, die andere Assistenten verwenden, behalten ihren bisherigen Anbieter.

Was nach der Verifizierung geschieht

Persona sendet einen Webhook an B2CORE, wenn sich der Status einer Inquiry ändert. B2CORE verarbeitet den Webhook wie folgt:

Hinweise:

• B2CORE speichert die Ausweisfotos und, wenn Selfies synchronisieren auf Yes gesetzt ist, das Selfie in den Dokumenten des Kunden.
• Nach einer Genehmigung aktualisiert B2CORE den Vor-, Mittel- und Nachnamen, das Geburtsdatum, das Land und die Adresse des Kunden mit den Daten, die Persona aus den Dokumenten extrahiert hat. Die Telefonnummer wird nicht aktualisiert.
• Wenn ein Compliance-Mitarbeiter im Back Office manuell eine Entscheidung trifft, hat diese Vorrang vor der Entscheidung von Persona.
• Doppelte und in falscher Reihenfolge eintreffende Webhooks verursachen keine Probleme: B2CORE liest stets den aktuellen Inquiry-Status von Persona aus.
• Geht ein Webhook verloren, verarbeitet B2CORE Inquiries erneut, die seit mehr als 6 Stunden auf eine Entscheidung warten (die Prüfung wird täglich ausgeführt).
• Inquiries, die ein Kunde begonnen, aber nicht eingereicht hat, erzeugen keine Verifizierungsanträge.

Von SumSub migrieren

1. Konfigurieren und aktivieren Sie die Persona-Verbindung.
2. Wählen Sie für jede Stufe, die Persona verwenden soll, die Inquiry-Vorlage aus und ändern Sie anschließend den Assistenten der Stufe zu PersonaSDK.
3. Deaktivieren Sie die SumSub-Verbindung.

Kunden behalten ihre aktuellen Verifizierungsstufen.

Fehlerbehebung

• Anträge bleiben ausstehend, nachdem der Kunde die Verifizierung abgeschlossen hat. Prüfen Sie, ob ein Persona-Workflow Inquiries genehmigt oder ablehnt, oder aktivieren Sie Abgeschlossene Prüfungen ohne Persona-Entscheidung genehmigen. Prüfen Sie außerdem, ob der Webhook mit allen erforderlichen Ereignissen erstellt wurde.
• Webhooks werden abgelehnt. Prüfen Sie, ob das Webhook-Geheimnis in der Verbindung mit dem Geheimnis des Webhooks in Persona übereinstimmt.
• Der Kunde sieht beim Starten der Verifizierung eine Fehlermeldung. Prüfen Sie, ob für die Stufe eine Inquiry-Vorlage ausgewählt ist (bei Firmenkunden wird die Vorlage für Einzelpersonen verwendet, wenn das Feld für die Firmenkundenvorlage leer ist).