Coincidencia de abonados

Subscriber Match compara los datos del usuario final de un número de teléfono con los que figuran en los archivos de su operador de telefonía móvil. La información puede incluir el nombre, la dirección, el código postal, el número de teléfono y la fecha de nacimiento del usuario, y Subscriber Match devolverá una respuesta de coincidencia para cada atributo dado; no se devuelve ninguna información personal identificable (PII). Esta información puede combinarse con todas las demás perspectivas disponible en la API.

Coincidencia de Abonado le permite:

  • Verify real users more quickly, reducing churn and improving the customer experience
  • Aumentar la tasa de conversión de altas de clientes
  • Reduzca el riesgo de suplantación de identidad y fraude de identidad sintético en su empresa
  • Conozca mejor a su cliente (KYC) para cumplir la normativa de su mercado
  • Combine perfectamente Subscriber Match con otros Insights, como SIM Swap o Location Verification, para identificar riesgos y asegurar las transacciones en línea.

Requisitos previos

Para utilizar Identity Insights, debe asegurarse de que su Account está configurado correctamente; consulte la sección Primeros pasos para obtener más información:

  • Crear una Account,
  • Creación de una aplicación de Vonage para su uso con la API Identity Insights,
  • Los diferentes entornos disponibles y cómo configurar su Account para utilizarlos,
  • Y cómo utilizar la interfaz de usuario de inicio del panel de control para utilizar la API sin escribir ningún código.

Esta guía explicará cómo utilizar el programa Subscriber Match Insight mediante cURL.

La API Identity Insights está disponible a través de varios puntos finales regionales. Los ejemplos de esta guía utilizan el punto final de la UE, pero puede consultar la lista completa en Detalles técnicos.

Realizar una llamada a la API

La autenticación para la API Identity Insights se realiza mediante JWT, un token JSON compacto y autocontenido. Para generar un JWT, puede utilizar nuestra herramienta generador en líneao, alternativamente, utilice el botón CLI de Vonage. Necesitará su ID de aplicación y su clave privada para generar el JWT. Una vez que tenga su JWT, puede enviar una solicitud a la API.

Este ejemplo muestra una solicitud cURL para que la información de coincidencia de suscriptor compare los campos contenidos en el archivo subscriber_matchpuede incluir tantos atributos en la matriz como desee:

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

A continuación, la API comparará la información asociada al usuario concreto del teléfono móvil con la que conste en los propios registros del operador del usuario del teléfono móvil, y devolverá un valor de coincidencia para cada atributo facilitado:

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

Cada campo dentro del subscriber_match tendrá uno de los siguientes valores:

  • EXACT - el valor proporcionado coincide exactamente.
  • HIGH - el valor proporcionado es una coincidencia aproximada pero imperfecta.
  • PARTIAL - el valor proporcionado coincide parcialmente.
  • LOW- el valor proporcionado sólo coincide ligeramente.
  • NONE - el valor proporcionado no coincide en absoluto.
  • DATA_UNAVAILABLE - no hay datos para el atributo de la solicitud.
  • INCLUDED_WITH_ADDRESS_MATCH - el valor proporcionado en el campo de entrada se ha tenido en cuenta al calcular el address_match campo de respuesta, pero no se ha evaluado de forma independiente.

Además, existe un status que muestra el resultado de la solicitud:

  • code - será uno de los siguientes valores:
    • UNAUTHORIZED - hay un problema con la autenticación de la solicitud.
    • INVALID_PURPOSE - la finalidad indicada en la solicitud no es válida.
    • INVALID_NUMBER_FORMAT - el formato del número de teléfono no es válido.
    • NOT_FOUND - el operador no puede encontrar el número de teléfono facilitado.
    • NO_COVERAGE - no hay cobertura para la API en el país en el que se encuentra el usuario.
    • INTERNAL_ERROR- la API ha devuelto un error.
    • SUPPLIER_ERROR - hay un problema con uno de los atributos proporcionados. Encontrará información más detallada en el message campo.
    • OK - la percepción se ha procesado correctamente.
    • SUBSCRIBER_MATCH.ID_DOCUMENT_REQUIRED - requiere que idDocument coincida con cualquier otro atributo.
    • SUBSCRIBER_MATCH.ID_DOCUMENT_MISMATCH - no puede coincidir con idDocument, que es necesario para coincidir con otros atributos.
    • SUBSCRIBER_MATCH.INVALID_PARAM_COMBINATION - La combinación de parámetros indicada no es válida.
  • message - contiene una descripción más detallada del estado.

Lecturas complementarias