Abonnenten-Match

Subscriber Match vergleicht die Endnutzerdaten für eine Telefonnummer mit den Daten, die bei ihrem Mobilfunkbetreiber gespeichert sind. Die Informationen können den Namen, die Adresse, die Postleitzahl, die Telefonnummer und das Geburtsdatum des Nutzers umfassen. Subscriber Match gibt für jedes Attribut eine Antwort auf die Übereinstimmung zurück - es werden keine personenbezogenen Daten (PII) zurückgegeben. Dieser Einblick kann mit allen anderen Informationen kombiniert werden. Einblicke in der API verfügbar.

Subscriber Match ermöglicht Ihnen das:

  • Verifizieren Sie echte Benutzer schneller, reduzieren Sie die Abwanderung und verbessern Sie das Kundenerlebnis.
  • Erhöhung der Konversionsrate von Kundenanmeldungen
  • Reduzieren Sie das Risiko von Identitätsdiebstahl und synthetischem Identitätsbetrug für Ihr Unternehmen
  • Besseres Wissen über Ihre Kunden (KYC) zur Einhaltung der Vorschriften in Ihrem Markt
  • Kombinieren Sie Subscriber Match nahtlos mit anderen Insights, wie SIM Swap oder Location Verification, um Risiken zu erkennen und Online-Transaktionen zu sichern.

Hinweis: Die Nutzung dieser Erkenntnisse in der Produktion erfordert die Genehmigung der Mobilfunkbetreiber, die über das "Network Registry" verwaltet wird. Um zu erfahren, wie Sie den Zugang beantragen können, folgen Sie dieser Leitfaden.

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 erklärt, wie man den Subscriber Match Insight programmatisch mit cURL verwendet.

Die Identity Insights API ist über mehrere regionale Endpunkte verfügbar. Die Beispiele in diesem Leitfaden verwenden den EU-Endpunkt, aber Sie finden die vollständige Liste unter Technische Details.

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 Subscriber Match Insight zum Vergleich der Felder in der subscriber_matchSie können so viele oder so wenige Attribute in das Array aufnehmen, wie Sie möchten:

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "3932462384260",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
        "subscriber_match": {
            "id_document": "66666666q",
            "given_name": "Federica",
            "family_name": "Sanchez Arjona",
            "street_name": "Crawfords Corner Road",
            "street_number": "4",
            "postal_code": "07733",
            "locality": "Holmdel",
            "region": "Monmouth County",
            "country": "US",
            "house_number_extension": "Suite 2416",
            "birthdate": "1978-08-22"
          }
        }
    }'

Die API vergleicht dann die Informationen, die mit dem jeweiligen Mobiltelefonbenutzer verbunden sind, mit den Informationen, die in den Aufzeichnungen des Betreibers des Mobiltelefons gespeichert sind, und gibt für jedes angegebene Attribut einen Übereinstimmungswert zurück:

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "subscriber_match": {
        "id_document_match": "EXACT",
        "given_name_match": "DATA_UNAVAILABLE",
        "family_name_match": "DATA_UNAVAILABLE",
        "address_match": "EXACT",
        "street_name_match": "EXACT",
        "street_number_match": "EXACT",
        "postal_code_match": "EXACT",
        "country_match": "EXACT",
        "birthdate_match": "NONE",
        "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:

Feld Beschreibung
status.code Code, der den Status der Anfrage angibt. Muss einer der folgenden sein:

NO_COVERAGE: Das Land oder das Mobilfunknetz wird von den verfügbaren Anbietern nicht unterstützt.
INVALID_PURPOSE: Der verwendete Zweck ist für diese Einsicht nicht gültig oder zulässig.
UNAUTHORIZED: Die Anfrage konnte für die Kombination aus Antrag, Lieferant und Telefonnummer nicht autorisiert werden.
INTERNAL_ERROR: Bei der Bearbeitung der Anfrage ist ein interner Fehler aufgetreten.
SUPPLIER_ERROR: Der Anbieter hat bei der Bearbeitung der Anfrage einen Fehler gemeldet.
NOT_FOUND: Die Rufnummer konnte für diese Einsicht nicht gefunden werden.
INVALID_NUMBER_FORMAT: Das Format der Telefonnummern ist für die Zuweisung durch die Netzbetreiber an die Benutzer nicht gültig.
SUBSCRIBER_MATCH.ID_DOCUMENT_REQUIRED: Der Operator verlangt, dass idDocument mit allen anderen Attributen übereinstimmt.
SUBSCRIBER_MATCH.ID_DOCUMENT_MISMATCH: Der Operator kann nicht mit idDocument übereinstimmen, das für die Übereinstimmung mit anderen Attributen erforderlich ist.
SUBSCRIBER_MATCH.INVALID_PARAM_COMBINATION: Die angegebene Parameterkombination ist ungültig.
OK: Die Einsicht wurde erfolgreich verarbeitet.
status.message Ausführlichere Statusbeschreibung.
Feld Beschreibung Obligatorisch
id_document_match Zeigt an, ob die mit dem Ausweisdokument des Kunden verbundene Identifikationsnummer mit der im System des Betreibers übereinstimmt. Nein
given_name_match Zeigt an, ob der Vorname/Gename des Kunden mit dem im System des Betreibers übereinstimmt. Nein
family_name_match Zeigt an, ob Nachname/Familienname/Nachname des Kunden mit dem im System des Betreibers übereinstimmen. Nein
address_match Zeigt an, ob die vollständige Adresse des Kunden mit derjenigen im System des Betreibers übereinstimmt. Nein
street_name_match Zeigt an, ob der Straßenname des Kunden mit dem Namen im System des Betreibers übereinstimmt. Nein
street_number_match Zeigt an, ob die Straßennummer des Kunden mit derjenigen im System des Betreibers übereinstimmt. Nein
postal_code_match Zeigt an, ob die Postleitzahl des Kunden mit der Postleitzahl im System des Betreibers übereinstimmt. Nein
locality_match Zeigt an, ob der Ort der Kundenadresse mit dem Ort im System des Betreibers übereinstimmt. Nein
region_match Zeigt an, ob die Region oder Präfektur des Kunden mit derjenigen im System des Betreibers übereinstimmt. Nein
country_match Zeigt an, ob das Land der Adresse des Kunden mit dem Land im System des Betreibers übereinstimmt. Nein
house_number_extension_match Zeigt an, ob die Hausnummer der Adresse des Kunden mit der im System des Betreibers übereinstimmt. Nein
birthdate_match Zeigt an, ob das Geburtsdatum des Kunden mit dem Geburtsdatum im System des Betreibers übereinstimmt. Nein

Jedes dieser Felder wird einen der folgenden Werte haben:

  • EXACT - der angegebene Wert genau übereinstimmt.
  • HIGH - der angegebene Wert ist eine enge, aber unvollkommene Übereinstimmung.
  • PARTIAL - der angegebene Wert stimmt teilweise überein.
  • LOW- der angegebene Wert stimmt nur geringfügig überein.
  • NONE - der angegebene Wert stimmt überhaupt nicht überein.
  • DATA_UNAVAILABLE - keine Daten für das Attribut "Anfrage" vorhanden sind.
  • INCLUDED_WITH_ADDRESS_MATCH - der im Eingabefeld angegebene Wert wurde bei der Berechnung der address_match Antwortfeld, aber es wurde nicht unabhängig bewertet.

Weitere Lektüre