Correspondance des abonnés

Le service Subscriber Match compare les données de l'utilisateur final d'un numéro de téléphone avec celles qui figurent dans les dossiers de l'opérateur de réseau mobile. Les informations peuvent inclure le nom, l'adresse, le code postal, le numéro de téléphone et la date de naissance de l'utilisateur, et Subscriber Match renvoie une réponse correspondant à chaque attribut donné - aucune information personnelle identifiable (PII) n'est renvoyée. Cette information peut être combinée avec toutes les autres perspectives disponibles dans l'API.

L'appariement des abonnés vous permet de

  • Verify les utilisateurs réels plus rapidement, ce qui permet de réduire le taux de désabonnement et d'améliorer l'expérience client.
  • Augmenter le taux de conversion des inscriptions des clients
  • Réduire le risque d'usurpation d'identité et de fraude à l'identité synthétique pour votre entreprise
  • Mieux connaître son client (KYC) pour se conformer aux réglementations en vigueur sur votre marché
  • Combiner de manière transparente Subscriber Match avec d'autres Insights, tels que SIM Swap ou Location Verification, afin d'identifier les risques et de sécuriser les transactions en ligne.

Conditions préalables

Pour utiliser Identity Insights, vous devez vous assurer que votre Account est correctement configuré. Pour commencer pour plus d'informations :

  • Création de votre Account,
  • Création d'une application Vonage à utiliser avec l'API Identity Insights,
  • Les différents environnements disponibles et comment configurer votre Account pour les utiliser,
  • Et comment utiliser l'interface utilisateur du tableau de bord pour utiliser l'API sans écrire de code.

Ce guide explique comment utiliser l'outil Subscriber Match Insight de manière programmatique à l'aide de cURL.

L'API Identity Insights est disponible via plusieurs points de terminaison régionaux. Les exemples de ce guide utilisent le point de terminaison de l'UE, mais vous pouvez en trouver la liste complète à l'adresse suivante Détails techniques.

Faire un appel à l'API

L'authentification pour l'API Identity Insights se fait par le biais de JWT, un jeton JSON compact et autonome. Pour générer un JWT, vous pouvez utiliser notre outil générateur en ligneou bien utiliser la fonction CLI Vonage. Vous aurez besoin de votre identifiant d'application et de votre clé privée pour générer le JWT. Une fois que vous avez votre JWT, vous pouvez envoyer une demande à l'API.

Cet exemple montre une requête cURL pour l'aperçu des correspondances d'abonnés afin de comparer les champs contenus dans le fichier subscriber_match; vous pouvez inclure dans le tableau autant ou aussi peu d'attributs que vous le souhaitez :

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"
          }
        }
    }'

L'API comparera alors les informations associées à l'utilisateur de téléphone portable avec celles contenues dans les dossiers de l'opérateur du téléphone portable, et renverra une valeur de correspondance pour chaque attribut fourni :

{
  "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"
      }
    }
  }
}

Chaque champ du subscriber_match aura l'une des valeurs suivantes :

  • EXACT - la valeur fournie correspond exactement.
  • HIGH - la valeur fournie est proche mais imparfaite.
  • PARTIAL - la valeur fournie correspond partiellement.
  • LOW- la valeur fournie ne correspond que légèrement.
  • NONE - la valeur fournie ne correspond pas du tout.
  • DATA_UNAVAILABLE - il n'y a pas de données détenues pour l'attribut de la demande.
  • INCLUDED_WITH_ADDRESS_MATCH - la valeur fournie dans le champ de saisie a été prise en compte lors du calcul de la address_match mais elle n'a pas été évaluée de manière indépendante.

En outre, il existe un status tableau indiquant le résultat de la demande :

  • code - sera l'une des valeurs suivantes :
    • UNAUTHORIZED - il y a un problème avec l'authentification de la demande.
    • INVALID_PURPOSE - l'objet fourni dans la demande n'est pas valide.
    • INVALID_NUMBER_FORMAT - le format du numéro de téléphone n'est pas valide.
    • NOT_FOUND - le numéro de téléphone fourni est introuvable par l'opérateur.
    • NO_COVERAGE - l'API n'est pas couverte dans le pays où se trouve l'utilisateur.
    • INTERNAL_ERROR- l'API a renvoyé une erreur.
    • SUPPLIER_ERROR - il y a un problème avec l'un des attributs fournis. Des informations plus détaillées seront données dans le message domaine.
    • OK - l'insight a été traité avec succès.
    • SUBSCRIBER_MATCH.ID_DOCUMENT_REQUIRED - exige que idDocument corresponde à tout autre attribut.
    • SUBSCRIBER_MATCH.ID_DOCUMENT_MISMATCH - ne peut pas faire correspondre idDocument qui est nécessaire pour faire correspondre tous les autres attributs.
    • SUBSCRIBER_MATCH.INVALID_PARAM_COMBINATION - La combinaison de paramètres indiquée n'est pas valide.
  • message - contient une description plus détaillée de l'état.

Pour en savoir plus