Abonnementsdauer [Entwickler-Vorschau]

Anhand der Vertragsdauer lässt sich überprüfen, ob ein Netzteilnehmer bereits seit einer bestimmten Mindestdauer Kunde des Mobilfunkbetreibers ist, um so ein gewisses Maß an Vertrauen in die zugehörige Netzanschluss-Kennung herzustellen.

Es richtet sich an Unternehmen und Dienstleister, die die Identität von Nutzern online überprüfen müssen – insbesondere aus den Bereichen Finanzdienstleistungen, Fintech, E-Commerce oder Telekommunikation –, die Betrugsfälle reduzieren und die Sicherheit bei der Entscheidungsfindung erhöhen möchten.

Zu den häufigsten Anwendungsfällen, in denen die Abonnementsdauer von Vorteil sein kann, gehören:

• Identitätsprüfung und Onboarding verbessern: Unternehmen können die Nutzungsdauer der Mobilfunknummer nutzen, um die Zuverlässigkeit der mobilen Identität eines Nutzers während des Onboardings oder der KYC-Prüfung zu bewerten. Eine lange Nutzungsdauer der Mobilfunknummer stärkt das Vertrauen in die Echtheit der Identität des Nutzers und ergänzt andere Prüfungen wie die Dokumentenüberprüfung oder den Abgleich mit dem Teilnehmerdatensatz. Dies trägt dazu bei, Betrugsfälle beim Onboarding zu reduzieren und das Vertrauen in die digitale Identitätsprüfung zu stärken.
• Verbesserung der Authentifizierungssicherheit: Die API unterstützt Authentifizierungsverfahren per Mobiltelefon wie die Nummernüberprüfung oder Einmalpasswörter (OTP) per SMS, indem sie einen Vertrauensfaktor auf der Grundlage der Nutzungsdauer der Telefonnummer hinzufügt. Ist eine Nummer bereits seit längerer Zeit aktiv, kann sie in Risikobewertungsmodellen priorisiert oder stärker gewichtet werden, während kürzlich aktivierte Nummern eine verstärkte Authentifizierung auslösen können.
• Verbesserung der Betrugserkennung und Risikobewertung: Systeme zur Betrugsbekämpfung können anhand von Nutzungsdauerdaten neu aktivierte oder kurzlebige Telefonnummern identifizieren, die auf synthetische Identitäten oder risikoreiche Aktivitäten hindeuten könnten. Dies ermöglicht die frühzeitige Erkennung potenzieller Betrugsfälle, bevor diese Transaktionen, Account-Änderungen oder andere sensible Vorgänge beeinträchtigen.
• Unterstützung bei der Risikobewertung im Finanzdienstleistungsbereich: Banken und Finanzinstitute können die Überprüfung der Nutzungsdauer in ihre Kreditvergabe- und Zahlungsabläufe integrieren. Indem sie prüfen, wie lange ein Nutzer seine Telefonnummer bereits nutzt, erhalten sie einen zusätzlichen Indikator für Glaubwürdigkeit und Stabilität, was dazu beiträgt, das Risiko von Identitätsbetrug oder falschen Applications zu verringern.

Voraussetzungen

Um Identity Insights nutzen zu können, müssen Sie sicherstellen, dass Ihr Account korrekt konfiguriert ist; siehe die Erste Schritte Leitfaden für weitere Informationen über:

• Erstellen Sie Ihren Account,
• Erstellen einer Vonage-Anwendung zur Verwendung mit der Identity Insights API,
• Die verschiedenen verfügbaren Umgebungen und wie Sie Ihren Account für deren Nutzung konfigurieren,
• Und wie Sie die Dashboard-Einstiegs-UI verwenden, um die API zu nutzen, ohne Code zu schreiben.

In dieser Anleitung wird erläutert, wie Sie das Programm „Subscriber Tenure Insight“ programmgesteuert mit cURL nutzen können.

Einen API-Aufruf tätigen

Die Authentifizierung für die Identity Insights API erfolgt über JWTs, ein kompaktes und in sich geschlossenes JSON-Token. Um ein JWT zu generieren, können Sie unser Online-Generatoroder verwenden Sie alternativ die Vonage CLI. Sie benötigen Ihre Anwendungs-ID und Ihren privaten Schlüssel, um das JWT zu erzeugen. Sobald Sie Ihr JWT haben, können Sie eine Anfrage an die API senden.

Dieses Beispiel zeigt eine cURL-Anfrage für den Einblick „Subscriber Tenure“, um zu überprüfen, ob der mit der angegebenen Telefonnummer verknüpfte Teilnehmer während des gesamten Überwachungszeitraums bei demselben Netzbetreiber geblieben ist; der Beginn des Überwachungszeitraums wird durch die date Parameter:

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
        	"subscriber_tenure": {
          "date": "2023-07-03"
          }
        }
    }'

Die API ruft dann die zu der jeweiligen Mobilfunknummer gehörenden Vertragsdauerangaben ab und gleicht diese mit dem in der Anfrage angegebenen Datum ab:

{
    "request_id": "f41087de-b9fc-4081-ab85-9d6475a19706",
    "insights": {
        "subscriber_tenure": {
            "is_tenure_met": true,
            "contract_type": "PREPAID",
            "status": {
                "code": "OK",
                "message": "Success"
            }
        }
    }
}

Hier ist die status Objekt zeigt den Status der Informationen an, die für die angegebene Telefonnummer zurückgegeben werden:

Wenn status.code in der Antwort lautet OKkönnen Sie auch die in der nachstehenden Tabelle beschriebenen Felder sehen. Wenn ein Feld in der Spalte "Obligatorisch" mit "Ja" markiert ist, wird es immer zurückgegeben, wenn der Status "OK" lautet. Ist ein Feld mit "Nein" gekennzeichnet, kann es sein, dass es nicht zurückgegeben wird.

Weitere Lektüre

• Lesen Sie mehr über die Identity Insights API in der API-Referenz.
• Wenn Sie Fragen haben, können Sie sich an uns wenden unter Vonage Gemeinschaft Slack.