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.

Remarque : l'utilisation de cet aperçu en production nécessite l'approbation des opérateurs de téléphonie mobile, qui est gérée par le "Registre du réseau". Pour savoir comment demander l'accès, suivez les instructions suivantes ce guide.

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

Ici, le status indique l'état des informations renvoyées pour le numéro de téléphone spécifié :

Champ d'application Description
status.code Code indiquant l'état de la demande. Doit être l'un des suivants :

NO_COVERAGE: Le pays ou le réseau mobile n'est pas pris en charge par les fournisseurs disponibles.
INVALID_PURPOSE: L'objectif utilisé n'est pas valide ou autorisé pour cet Insight.
UNAUTHORIZED: La demande n'a pas pu être autorisée pour la combinaison de l'application, du fournisseur et du numéro de téléphone.
INTERNAL_ERROR: Une erreur interne s'est produite lors du traitement de la demande.
SUPPLIER_ERROR: Le fournisseur a renvoyé une erreur lors du traitement de la demande.
NOT_FOUND: Le numéro de téléphone n'a pas pu être trouvé pour ce Numbers.
INVALID_NUMBER_FORMAT: Le format du numéro de téléphone n'est pas valide pour être attribué par les opérateurs aux utilisateurs.
SUBSCRIBER_MATCH.ID_DOCUMENT_REQUIRED: L'opérateur exige que idDocument corresponde à tout autre attribut.
SUBSCRIBER_MATCH.ID_DOCUMENT_MISMATCH: L'opérateur 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.
OK: L'insight a été traité avec succès.
status.message Description plus détaillée de l'état.
Champ d'application Description Obligatoire
id_document_match Indique si le numéro d'identification associé au document d'identité du client correspond à celui du système de l'opérateur. Non
given_name_match Indique si le prénom/prénom du client correspond à celui du système de l'opérateur. Non
family_name_match Indique si le nom de famille du client correspond à celui du système de l'opérateur. Non
address_match Indique si l'adresse complète du client correspond à celle du système de l'opérateur. Non
street_name_match Indique si le nom de rue du client correspond à celui du système de l'opérateur. Non
street_number_match Indique si le numéro de rue du client correspond à celui du système de l'opérateur. Non
postal_code_match Indique si le code postal du client correspond à celui du système de l'opérateur. Non
locality_match Indique si la localité de l'adresse du client correspond à celle du système de l'opérateur. Non
region_match Indique si la région ou la préfecture du client correspond à celle du système de l'opérateur. Non
country_match Indique si le pays de l'adresse du client correspond à celui du système de l'opérateur. Non
house_number_extension_match Indique si l'extension du numéro de maison de l'adresse du client correspond à celle du système de l'opérateur. Non
birthdate_match Indique si la date de naissance du client correspond à celle du système de l'opérateur. Non

Chacun de ces champs 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.

Pour en savoir plus