> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Regpit mit anny verbinden
> Automatisiere KYC- und GWG-Prüfungen bei Abo-Anfragen mit der Regpit-Integration.
[Regpit](https://regpit.com) ist eine Plattform für automatisierte Identitäts- und Risikoprüfungen (KYC/AML). Mit der Integration kann anny Abo-Anfragen automatisch an eine Verifizierung in Regpit knüpfen und die Freigabe vom Ergebnis abhängig machen.
Mit Regpit kannst du in anny:
* Abo-Anfragen automatisch an eine Identitätsprüfung koppeln
* Den Verifizierungsstatus direkt auf der Kunden- und Abo-Page einsehen
* Abo-Anfragen erst nach erfolgreicher Risikobewertung freigeben lassen
Besonders praktisch ist die Integration, wenn du abonnierbare Leistungen anbietest, die unter GWG-Vorgaben fallen, zum Beispiel virtuelle Briefkästen oder Geschäftsadressen.
Verfügbar ab dem Essential-Plan. Das Feature „Abos & Mitgliedschaften“ muss aktiviert sein.
## Typische Anwendungsfälle
| Anwendungsfall | Beschreibung |
| :--------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Virtuelle Briefkästen vermieten | **Identität vor Freigabe prüfen.** Bevor eine Geschäftsadresse genutzt werden kann, verifiziert Regpit automatisch die Identität. Du sparst manuelle GWG-Prüfschritte. |
| Geschäftsadressen als Abo anbieten | **GWG-konforme Freigabe sicherstellen.** Abo-Anfragen werden erst bestätigt, wenn das Gesamtrisiko unter dem definierten Schwellenwert liegt. |
| KYC-Pflichten zentral nachhalten | **Verifizierungsstatus transparent machen.** Support- und Operations-Teams sehen auf einen Blick, ob Daten fehlen, die Prüfung läuft oder die Anfrage nicht freigegeben werden darf. |
## Wie die Regpit-Verbindung funktioniert
Die Authentifizierung erfolgt über ein technisches Regpit-Nutzerkonto. In anny trägst du **Tenant-ID**, **E-Mail** und **Passwort** ein und prüfst die Verbindung. Danach erzeugst du in anny eine **Webhook-Konfiguration** und leitest sie an deine Kontaktperson bei Regpit weiter. Über diese Konfiguration meldet Regpit seine Ergebnisse zurück an anny.
Bevor die Prüfung startet, wählst du eine **Verifizierungsstrategie**: **Verifizierung vor Abonnementstart** (das Abo bleibt eine Anfrage, bis die Prüfung erfolgreich ist) oder **Verifizierung nach Abonnementstart** (das Abo startet sofort, die Prüfung läuft nachgelagert innerhalb einer Frist).
Sobald die Verbindung steht, kommunizieren anny und Regpit per Webhook:
| Daten | Richtung | Häufigkeit |
| ------------------------------------------------------------------- | ------------- | ---------------------- |
| Neue Cases (bei Abo-Anfrage) | anny → Regpit | Echtzeit |
| Kundendaten für die Prüfung (Name, E-Mail, Anschrift, Geburtsdaten) | anny → Regpit | Echtzeit |
| Verifizierungsergebnis & Risikobewertung | Regpit → anny | Echtzeit (per Webhook) |
Der Ablauf im Detail (Modus **Verifizierung vor Abonnementstart**):
1. Eine Kund:in stellt eine Abo-Anfrage für einen Plan mit aktiver Regpit-Verbindung.
2. anny erstellt automatisch einen Case in Regpit und fordert die Kund:in per E-Mail zur Verifizierung auf.
3. anny übermittelt die vorhandenen Kunden- und Unternehmensdaten an Regpit, dort läuft die Identitätsprüfung per Video-Verfahren.
4. Regpit bewertet das Gesamtrisiko und gibt das Ergebnis per Webhook an anny zurück.
5. Liegt das Risiko höchstens auf dem festgelegten **maximalen Risikolevel** und liegen alle Daten vor, wird die Abo-Anfrage bestätigt.
6. Ist das Risiko höher oder fehlen Informationen, bleibt die Anfrage unbestätigt.
Im Modus **Verifizierung nach Abonnementstart** startet das Abonnement sofort und die Prüfung läuft nachgelagert. Schließt die Kund:in die Verifizierung nicht innerhalb der **Verifizierungsfrist** ab oder schlägt die Prüfung fehl, wird das Abonnement gekündigt, sofern die entsprechende Option aktiv ist.
Eine unbestätigte Abo-Anfrage ist kein Fehler. Sie kann ein erwartetes Ergebnis sein, wenn Daten fehlen oder das Gesamtrisiko zu hoch ist.
## Regpit verbinden
### Voraussetzungen
Bevor du Regpit verbindest, stelle sicher, dass du Folgendes hast:
* Ein technisches Regpit-Nutzerkonto mit **Tenant-ID**, **E-Mail** und **Passwort**
* Eine Kontaktperson bei Regpit, die die Webhook-Konfiguration entgegennehmen kann
* Mindestens einen Abo-Plan in anny, für den eine Identitätsprüfung erforderlich ist
* Admin-Rechte in anny
### Verbindung einrichten
Öffne **Avatar** → **Account-Einstellungen** → **Integrationen** und gehe zu **Regpit**. Trage **Tenant-ID**, **E-Mail** und **Passwort** deines technischen Regpit-Kontos ein und klicke auf **Authentifizierung überprüfen**.
Erstelle die Webhook-Konfiguration und teile die Werte mit Regpit:
1. Klicke auf **Webhook-Konfiguration generieren**.
2. Kopiere die erstellten Werte (**Webhook-URL**, **Tenant-ID**, **Webhook-Token** und **Benutzer-E-Mail**) über **Alle in die Zwischenablage kopieren**.
3. Leite die Werte an deine Kontaktperson bei Regpit weiter, damit Regpit den Webhook auf seiner Seite einrichtet.
4. Klicke auf **Webhook-Verbindung testen**. anny prüft, ob eine Testmeldung von Regpit ankommt. Ohne erfolgreichen Test lässt sich die Integration nicht aktivieren.
Öffne die **Verifizierungseinstellungen** und wähle die **Verifizierungsstrategie**: **Verifizierung vor Abonnementstart** oder **Verifizierung nach Abonnementstart**. Für „nach Abonnementstart" legst du zusätzlich die **Verifizierungsfrist (Tage)** fest und entscheidest, ob das Abonnement bei unvollständiger Verifizierung nach Fristablauf gekündigt wird.
Klicke im Bereich **Regpit-Einstellungen** auf **Hinzufügen**. Wähle im Dialog **Regpit-Verbindung hinzufügen** den **Abo-Plan** und das **Maximale Risikolevel zum Bestätigen**. Optional aktivierst du **Natürliche Personen von der Verifizierung ausschließen**, damit Privatpersonen ohne Unternehmen nicht geprüft werden.
Aktiviere die Integration über den **Toggle** oben rechts. Danach werden neue Abo-Anfragen für die verbundenen Pläne automatisch an Regpit weitergeleitet. Erkennbar ist die aktive Prüfung an der Verifizierungskomponente auf der **Kunden-Page** und der **Abo-Page**.
Sobald die Verbindung aktiv ist, werden neue Abo-Anfragen für den konfigurierten Plan automatisch an Regpit weitergeleitet.
## Einschränkungen
Die Regpit-Integration unterstützt nicht:
* Einzelne Buchungen oder Bestellungen: Die Prüfung ist ausschließlich an Abo-Anfragen gekoppelt.
* Automatische Ablehnung bei zu hohem Risiko: Im Modus **Verifizierung vor Abonnementstart** bleibt eine Anfrage unbestätigt statt automatisch abgelehnt zu werden. Im Modus **Verifizierung nach Abonnementstart** kündigt anny das Abonnement dagegen automatisch, wenn die Prüfung fehlschlägt oder die Verifizierungsfrist abläuft.
* Self-Service-Aktivierung: Die Webhook-Konfiguration muss manuell an Regpit weitergegeben werden.
## Verbindung trennen
Wenn du die Integration deaktivierst, bleiben bestehende Cases und die Verifizierungsanzeige in anny erhalten, aber es werden keine Updates mehr von Regpit empfangen. Neue Abo-Anfragen werden dann nicht mehr automatisch bestätigt. Beim Löschen wird zusätzlich die Webhook-Konfiguration entfernt: Regpit kann anny danach nicht mehr erreichen. Zum erneuten Verbinden musst du eine neue Webhook-Konfiguration generieren und an Regpit übermitteln.
Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**.
## FAQ
Nein. Die Prüfung betrifft nur Abo-Pläne, denen du die Regpit-Verbindung explizit zugewiesen hast. Alle anderen Pläne bleiben davon unberührt.
Auf der **Kunden-Page** und auf der **Abo-Page** zeigt eine eigene Komponente den Verifizierungsstatus an: ob die Prüfung läuft, abgeschlossen ist oder Daten fehlen.
Im Modus **Verifizierung vor Abonnementstart** bleibt die Abo-Anfrage unbestätigt. Sie wird nicht automatisch abgelehnt oder gelöscht, dein Team kann den Fall in Regpit prüfen und manuell entscheiden. Im Modus **Verifizierung nach Abonnementstart** läuft das Abonnement bereits; eine fehlgeschlagene Prüfung oder eine versäumte Verifizierungsfrist kündigt es.
Bei **Verifizierung vor Abonnementstart** bleibt das Abo eine Anfrage und wird erst nach erfolgreicher Prüfung mit akzeptablem Risiko bestätigt. Bei **Verifizierung nach Abonnementstart** startet das Abo sofort und die Prüfung läuft nachgelagert innerhalb der **Verifizierungsfrist**. Du wählst die Strategie in den **Verifizierungseinstellungen**.
Nur, wenn du es möchtest. Aktivierst du beim Verbinden eines Plans **Natürliche Personen von der Verifizierung ausschließen**, werden Kund:innen, die als natürliche Person erkannt werden, für diesen Plan nicht durch die Prüfung geschickt.
Der fachliche Prüfungs-Flow läuft über Regpit. Admins können dort Cases einsehen und bei Bedarf eingreifen. Die Freigabe in anny erfolgt automatisch, wenn die Bedingungen erfüllt sind.
## Troubleshooting
Das Benachrichtigungssystem sendet die E-Mail automatisch, sobald der Case in Regpit erstellt wird. Prüfe den Spam-Ordner der Kund:in. Falls das Problem bestehen bleibt, kontaktiere den anny Support, da es sich um ein Webhook-Timing-Problem handeln kann.
Prüfe in Regpit, ob der Case tatsächlich mit einem freigabefähigen Ergebnis abgeschlossen wurde. Liegt das Gesamtrisiko über dem definierten Schwellenwert, bleibt die Anfrage bewusst unbestätigt. Zusätzlich kann ein Webhook-Ausfall dazu führen, dass der Status in anny nicht aktualisiert wurde. Kontaktiere in dem Fall den anny Support.
Das kann auftreten, wenn der abschließende Webhook von Regpit nicht bei anny angekommen ist und der Status auf „ausstehend“ hängen geblieben ist. Löse die Prüfung über die Aktion **Identitätsverifizierungen erneut auslösen** in der Regel-Tabelle erneut aus, damit anny den aktuellen Stand von Regpit nachholt. Bleibt das Problem bestehen, kontaktiere den anny Support.
> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Regpit ist eine Identitäts-/Risikoprüfung (KYC/GWG) für Abonnements, KEINE Smart-Lock- oder Zutritts-Integration. Die Prüfung greift ausschließlich bei Abo-Anfragen (Plan-Subscriptions), nie bei Einzelbuchungen oder Bestellungen.
>
> **UI-Pfad:** **Avatar** → **Account-Einstellungen** → **Integrationen** → **Regpit**. Panels in dieser Reihenfolge: „Regpit Authentifizierung" (Felder Tenant-ID, E-Mail, Passwort; Hinweis „Technischer User Account"; Button „Authentifizierung überprüfen"), „Webhook-Konfiguration" (Button „Webhook-Konfiguration generieren" → Werte Webhook-URL, Tenant-ID, Webhook-Token, Benutzer-E-Mail; Button „Webhook-Verbindung testen"), „Verifizierungseinstellungen" (Verifizierungsstrategie; bei „nach Abonnementstart" zusätzlich „Verifizierungsfrist (Tage)" und Toggle „Abonnement kündigen … nach Ablauf der Frist"), „Regpit-Einstellungen" (Regel-Tabelle mit Spalten „Plan", „Maximales Risikolevel zum Bestätigen", „Natürliche Personen ausschließen"; Button „Hinzufügen" → Dialog „Regpit-Verbindung hinzufügen").
>
> **Authentifizierung:** technisches Regpit-Nutzerkonto (Tenant-ID + E-Mail + Passwort), NICHT die Webhook-Konfiguration. Die Webhook-Konfiguration ist ein separater zweiter Schritt für eingehende Meldungen (Regpit → anny). Aktivierung per Toggle ist erst möglich, wenn eine Webhook-Konfiguration existiert UND der Webhook-Test erfolgreich war.
>
> **Verifizierungsstrategien:** (1) „Verifizierung vor Abonnementstart" (Standard): Abo bleibt Anfrage; bei erfolgreicher Prüfung mit Risiko ≤ „Maximales Risikolevel zum Bestätigen" wird bestätigt, sonst bleibt es unbestätigt (keine automatische Ablehnung/Löschung). anny erzwingt für verbundene Pläne, dass sie eine Bestätigung erfordern. War die Kund:in bereits verifiziert, wird sofort bestätigt (kein neuer Case). (2) „Verifizierung nach Abonnementstart": Abo startet sofort; Prüfung nachgelagert innerhalb der „Verifizierungsfrist (Tage)" (Standard 28). Fehlgeschlagene Prüfung ODER Fristablauf (bei aktiver Kündigungs-Option) kündigt das Abonnement. Erinnerungen an die Kund:in etwa alle 3 Tage plus vor Fristablauf, nur in diesem Modus.
>
> **Risikolevel:** sechs Stufen (Niedrig, Mittel niedrig, Mittel, Mittel hoch, Hoch, Sehr hoch), pro Plan als Höchstwert wählbar. „Natürliche Personen ausschließen" pro Plan: überspringt die Prüfung für Kund:innen ohne erkanntes Unternehmen (Erkennung per Firmenname/Rechtsform).
>
> **Datenfluss an Regpit (Datenschutz):** Name/Firmenname, E-Mail, Anschrift, Geburtsdatum, Geburtsname, Geburtsort. Prüfung per Video-Verfahren bei Regpit.
>
> **Verifikationsstatus** sichtbar auf Kunden-Page UND Abo-Page (eigene Komponente).
>
> **Hängende Prüfungen:** Fällt ein Regpit-Webhook aus, bleibt der Status „ausstehend". Selbst-Lösung: Aktion „Identitätsverifizierungen erneut auslösen" in der Regel-Tabelle (pro Regel); alternativ anny Support.
>
> **Deaktivieren:** Cases/Verifizierungsanzeige bleiben, keine Updates mehr von Regpit, keine automatische Bestätigung neuer Anfragen. **Löschen:** entfernt zusätzlich die Webhook-Konfiguration (Token), Regpit erreicht anny danach nicht mehr; erneutes Verbinden erfordert eine neue Konfiguration.
>
> **Verwandte Artikel:** Einrichtung Abo-Management, Communities (Abo-basierte Zugangssteuerung).