B2BROKER
B2CORE
B2CORE IB
B2TRADER
B2CONNECT
B2TRANSLATE
B2BROKERSo verwenden Sie SumSub
Erfahren Sie, wie Sie SumSub als KYC- und KYT-Anbieter in B2CORE verbinden und konfigurieren, einschließlich Dokumenteinrichtung, Verifizierungsstufen, Abläufen und Webhook-Einstellungen
Dieser Artikel enthält Anweisungen zur Konfiguration von B2CORE für die Nutzung des KYC- und KYT-Anbieters SumSub.
Bevor Sie mit den Anweisungen fortfahren, müssen Sie sich bei SumSub registriert haben und über ein aktives Konto verfügen. Für KYT-Prüfungen muss außerdem SumSub Fraud Prevention aktiviert und ordnungsgemäß konfiguriert sein.
So konfigurieren Sie eine Verbindung zu SumSub
Nur Administratoren mit Berechtigungen zur Verwaltung externer Verbindungen können eine Verbindung zu SumSub einrichten.
So richten Sie eine Verbindung ein:
Navigieren Sie im B2CORE Back Office zu System > External connections.
Klicken Sie oben rechts auf der Seite auf +Create.
Füllen Sie auf der Seite Create connection die folgenden Felder aus:
- Geben Sie im Feld Name einen Namen ein, den Sie für die Verbindung verwenden möchten.
- Geben Sie im Feld Caption eine Bezeichnung ein, die auf die Verbindung im Back Office angewendet wird.
- Wählen Sie in der Dropdown-Liste Provider die Option SumSubstance aus.
Klicken Sie auf Save, um die Verbindung zu erstellen.
Suchen Sie in der Liste der Verbindungen die von Ihnen erstellte SumSub-Verbindung und klicken Sie auf Edit, um die Verbindungsdetails einzugeben.
Geben Sie auf der Seite Edit connection die folgenden Einstellungen an:
- Geben Sie im Feld Service Location
https://api.sumsub.com/an. - Geben Sie im Feld Client ID den Namen Ihres SumSub-Kontos an. Um Ihren Kontonamen anzuzeigen, navigieren Sie in der SumSub-Oberfläche zu Settings > Account Details.
- Geben Sie im Feld Webhook Secret Key ein Webhook-Secret an. Sie sollten den Webhook in der SumSub-Oberfläche generieren. Navigieren Sie dazu in der SumSub-Oberfläche zu Dev space > Webhooks (die erforderliche Webhook-Konfiguration finden Sie unter SumSub-WebHook-Konfiguration).
- Lassen Sie die Felder Login und Password leer.
- Geben Sie in den Feldern Token und Token Secret einen Token und einen Secret-Key-Wert an, die in der SumSub-Oberfläche generiert wurden. Um sie zu generieren, navigieren Sie in der SumSub-Oberfläche zu Dev space > App Tokens.
- Um unterschiedliche Verifizierungsabläufe für individuelle und Unternehmens-Kunden anzuwenden, wählen Sie in der Dropdown-Liste Client Resetting Mode die Option Enabled aus.
Wenn die Option Client Resetting Mode aktiviert ist, bedeutet dies, dass für Kunden, deren Typ von individuell zu Unternehmen oder umgekehrt geändert wurde, eine erneute Verifizierung erforderlich ist. Nach einer Typänderung geschieht Folgendes:
- Im B2CORE Back Office wird die Verifizierungsstufe eines Kunden auf
Level 0, die Standardverifizierungsstufe, zurückgesetzt. - Alle ausstehenden Kundenanfragen zum Erhalt einer höheren Verifizierungsstufe werden automatisch abgelehnt.
- Im SumSub-System wird ein Antragsteller auf die ursprüngliche Stufe zurückgesetzt und alle zuvor für diesen Antragsteller hochgeladenen Dokumente werden ungültig.
Alle Dateien und Dokumente, die zuvor für diesen Kunden im B2CORE Back Office hochgeladen wurden, bleiben weiterhin verfügbar.
Konfigurieren Sie im Abschnitt Transaction monitoring die Einstellungen für KYT-Prüfungen mit SumSub Fraud Prevention. Diese Prüfungen werden derzeit für Ein- und Auszahlungen in Fiat- und Kryptowährungen unterstützt.
-
Wählen Sie in der Dropdown-Liste Enabled:
- Yes — um die Transaktionsüberwachung über SumSub zu aktivieren und Ergebnisse in B2CORE zu erhalten.
- No — um die Transaktionsüberwachung über SumSub zu deaktivieren.
-
In der Dropdown-Liste Currency Filter:
- Wählen Sie eine oder mehrere Währungen aus, um Transaktionen nur in den ausgewählten Währungen zu überwachen.
- Lassen Sie die Liste leer, um Transaktionen in allen Währungen zu überwachen.
Klicken Sie auf Save, um die Einstellungen zu übernehmen.
So erstellen Sie Dokumentgruppen für die SumSub-Verifizierung
Erstellen Sie Dokumentgruppen, damit Kunden verschiedene von SumSub unterstützte Dokumente zur Verifizierung einreichen können. Erstellen Sie für jedes Dokument (z. B. Personalausweis, Reisepass, Führerschein und andere), das Sie für die Verifizierung verfügbar machen möchten, eine separate Dokumentgruppe mit dem entsprechenden Namen.
So erstellen Sie eine Dokumentgruppe:
Navigieren Sie im B2CORE Back Office zu Verification > Document groups.
Klicken Sie oben rechts auf der Seite auf +Create.
Füllen Sie auf der Seite Create document group die folgenden Felder aus:
- Geben Sie im Feld Name den Namen einer Dokumentgruppe an.
Stellen Sie sicher, dass Sie die Namen der Dokumentgruppen exakt wie die Namen der von SumSub unterstützten Dokumenttypen angeben, z. B. ID_CARD, PASSPORT, DRIVERS, RESIDENCE_PERMIT usw.
Wenn Sie beispielsweise möchten, dass Ihre Kunden ihre Personalausweise zur Dokumentverifizierung einreichen können, erstellen Sie eine Dokumentgruppe mit dem Namen ID_CARD.
- Geben Sie im Feld Caption eine Bezeichnung für die Dokumentgruppe an, die in der B2CORE-Benutzeroberfläche angezeigt wird.
- Wählen Sie in der Dropdown-Liste Type die Option One aus.
- Geben Sie im Feld Description eine Beschreibung für die Dokumentgruppe an, die im Back Office verwendet wird.
Stellen Sie sicher, dass in der Dropdown-Liste Enabled die Option Yes ausgewählt ist.
Klicken Sie auf Save, um die Dokumentgruppe zu erstellen.
So erstellen Sie Dokumenttypen für die SumSub-Verifizierung
Erstellen Sie für jede Dokumentgruppe, die Sie erstellt haben, einen Dokumenttyp.
So erstellen Sie einen Dokumenttyp:
Navigieren Sie im B2CORE Back Office zu Verification > Document types.
Klicken Sie oben rechts auf der Seite auf +Create.
Füllen Sie auf der Seite Create document type die folgenden Felder aus:
- Geben Sie im Feld Name den Namen eines Dokumenttyps an.
Die Namen der Dokumenttypen müssen mit den Namen der zuvor erstellten Dokumentgruppen übereinstimmen. Beispiel: ID_CARD, PASSPORT, DRIVERS, RESIDENCE_PERMIT usw.
- Geben Sie im Feld Caption eine Bezeichnung für den Dokumenttyp an, die in der B2CORE-Benutzeroberfläche angezeigt wird.
- Geben Sie im Feld Description eine Beschreibung für den Dokumenttyp an, die in der B2CORE-Benutzeroberfläche angezeigt wird.
- Wählen Sie in der Dropdown-Liste Group eine Dokumentgruppe aus, der dieser Dokumenttyp zugeordnet werden soll.
- Geben Sie im Feld Max files die maximale Anzahl an Dateien an, die Kunden für diesen Dokumenttyp hochladen können.
Wählen Sie in der Dropdown-Liste Status die Option Enabled aus.
Klicken Sie auf Save, um den Dokumenttyp zu erstellen.
So erstellen Sie Verifizierungsstufen für SumSub im B2CORE Back Office
Sie können Verifizierungsstufen erstellen oder bestehende Stufen ändern, um SumSub für die Verifizierung zu verwenden.
So erstellen Sie eine Verifizierungsstufe:
Navigieren Sie im B2CORE Back Office zu Verification > Levels.
Klicken Sie oben rechts auf der Seite auf +Create.
Füllen Sie auf der Seite Create verification level die folgenden Felder aus:
-
Geben Sie im Feld Index einen ganzzahligen Wert ungleich null an.
Der Index null (
0) wird immer der Standardverifizierungsstufe zugewiesen. Für andere Verifizierungsstufen muss der Index größer als null sein, z. B.1für Stufe 1,2für Stufe 2 usw. -
Wählen Sie in der Dropdown-Liste Wizard
SnsWizardSDKaus. -
Geben Sie im Feld Caption einen Stufennamen an, der in der B2CORE-Benutzeroberfläche und der mobilen App angezeigt wird, z. B.
Level 1. Geben Sie bei Bedarf die Lokalisierungseigenschaften für dieses Feld an, indem Sie auf die Schaltfläche rechts neben dem Feld klicken. -
Geben Sie im Feld Desktop Description eine Beschreibung der Stufe an, die in der B2CORE-Benutzeroberfläche angezeigt werden soll. Diese Beschreibung kann die Berechtigungen enthalten, die Kunden nach Erhalt dieser Stufe gewährt werden.
Die Beschreibung für die B2CORE-Benutzeroberfläche kann im HTML-Format angegeben werden. Geben Sie bei Bedarf die Lokalisierungseigenschaften für dieses Feld an.
-
Geben Sie im Feld Mobile Description eine Stufenbeschreibung an, die in der mobilen App angezeigt werden soll.
Die Beschreibung für die mobile App kann im JSON-Format angegeben werden. Geben Sie bei Bedarf die Lokalisierungseigenschaften für dieses Feld an.
-
Wählen Sie in der Dropdown-Liste Visible die Option Yes aus.
-
Wählen Sie in der Dropdown-Liste Default die Option No aus. (
Level 0ist immer die Standardverifizierungsstufe.) -
Wählen Sie in der Dropdown-Liste Assigned Client Right eine Berechtigungsstufe aus, die den Satz an Berechtigungen definiert, den Sie Ihren Kunden nach Erhalt dieser Verifizierungsstufe gewähren möchten (Details finden Sie unter Kundenrechte).
-
Wählen Sie in der Dropdown-Liste Document groups eine oder mehrere erforderliche Dokumentgruppen aus. Sie können beispielsweise
ID_CARDundRESIDENCE_PERMITauswählen, wenn Ihre Kunden ihre Personalausweise und Aufenthaltstitel zur Verifizierung einreichen sollen, um diese Stufe zu erhalten. -
Wählen Sie optional in der Dropdown-Liste Client tests einen oder mehrere Akkreditierungstests aus, wenn Sie Ihre Kunden dazu verpflichten möchten, diese Tests zu bestehen, bevor sie ihre Dokumente zur Verifizierung einreichen können. Die Liste der verfügbaren Tests umfasst alle Tests mit der Sichtbarkeitseinstellung Yes, die auf der Seite Kundentests angezeigt werden.
Klicken Sie auf Save, um die Stufe zu erstellen.
So erstellen Sie Stufen und Abläufe in der SumSub-Oberfläche
Das B2CORE Back Office unterstützt zwei Kundentypen: individuell und Unternehmen. Das SumSub-System bietet die Möglichkeit, für jeden Typ einen separaten Verifizierungsablauf einzurichten. Um diese Option zu verwenden, stellen Sie sicher, dass Sie beim Konfigurieren einer Verbindung zu SumSub den Client Resetting Mode aktiviert haben.
So fügen Sie eine neue Stufe hinzu:
Navigieren Sie in der SumSub-Oberfläche zu Integrations > Applicant Levels.
Klicken Sie auf Add new level.
Wählen Sie die erforderlichen Schritte aus.
Stufennamen müssen in den folgenden Formaten angegeben werden:
- Für individuelle Kunden:
level1,level2usw. - Für Unternehmens-Kunden:
level3corporate,level4corporateusw.
Diese Formate gewährleisten die korrekte Zuordnung zwischen Stufen in SumSub und B2CORE. Die Zuordnung basiert auf dem Index, der jeder Verifizierungsstufe in B2CORE zugewiesen ist. Sie finden die Indizes in der entsprechenden Spalte auf der Seite Verification > Levels des B2CORE Back Office und können sie in den Stufennamen für SumSub verwenden. Beispiel:
level1in SumSub entspricht der Stufe mit Index = 1 in B2CORE.level2in SumSub entspricht der Stufe mit Index = 2 in B2CORE.level3corporatein SumSub entspricht der Stufe mit Index = 3 in B2CORE.level4corporatein SumSub entspricht der Stufe mit Index = 4 in B2CORE usw.
So fügen Sie einen neuen Ablauf hinzu:
Navigieren Sie in der SumSub-Oberfläche zu Integrations > Verification Flow.
Klicken Sie auf Add new.
Wählen Sie die erforderlichen Optionen aus. Wählen Sie für jeden Ablauf eine kompatible Stufe aus.
SumSub-WebHook-Konfiguration
Überprüft
- Name:
REVIEWED - Empfänger:
HTTP Endpoint - Ziel:
https://{your-Back-Office-URL}/api/v1/verification-sns/handle - Typ:
Applicant reviewed (applicantReviewed) - Secret Key: der in SumSub generierte Secret Key
Stellen Sie sicher, dass Sie {your-Back-Office-URL} durch die Domain Ihres B2CORE Back Office ersetzen, nicht durch die B2CORE-Benutzeroberfläche. Das Ziel für Webhooks kann beispielsweise folgendermaßen aussehen: https://example.com/api/v1/verification-sns/handle.
Zuletzt aktualisiert am