Partida de abonados [Beta]

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

Coincidencia de Abonado le permite:

  • Verify a los usuarios reales con mayor rapidez, reduciendo la pérdida de clientes y mejorando la experiencia del cliente
  • Aumentar la tasa de conversión de los registros de clientes
  • Reduce el riesgo de robo de identidad y de fraude de identidad sintética en tu 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.

Nota: El uso de esta información en entorno de producción requiere la autorización de los operadores de telefonía móvil, que se gestiona a través del «Registro de redes». Para saber cómo solicitar el acceso, sigue esta guía.

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 tu Account,
  • Creación de una aplicación de Vonage para su uso con la API Identity Insights,
  • Los distintos entornos disponibles y cómo configurar tu Account para utilizarlos,
  • Y cómo utilizar la interfaz de usuario «Primeros pasos» del panel de control para utilizar la API sin tener que escribir código.

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

La API de Identity Insights está disponible a través de varios puntos de conexión regionales. Los ejemplos de esta guía utilizan el punto de conexión de la UE, pero puedes 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ínea, o bien utiliza el 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 obtener información sobre la coincidencia de suscriptores, con el fin de comparar los campos que contiene el 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"
      }
    }
  }
}

Aquí, el status indica el estado de la información devuelta para el número de teléfono especificado:

Campo Descripción
status.code Código que indica el estado de la solicitud. Debe ser uno de los siguientes:

NO_COVERAGE: El país o la red móvil no son compatibles con los proveedores disponibles.
INVALID_PURPOSE: El propósito utilizado no es válido o no está permitido para este Insight.
UNAUTHORIZED: No se ha podido autorizar la solicitud para la combinación de solicitud, proveedor y número de teléfono.
INTERNAL_ERROR: Se ha producido un error interno al procesar la solicitud.
SUPPLIER_ERROR: El proveedor ha devuelto un error al procesar la solicitud.
NOT_FOUND: No se ha podido encontrar el número de teléfono correspondiente a este Insight.
UNSUPPORTED_NETWORK_TYPE: El tipo de red no es compatible con este Insight.
INVALID_NUMBER_FORMAT: El formato de número de teléfono no es válido para que las operadoras lo asignen a los usuarios.
SUBSCRIBER_MATCH.ID_DOCUMENT_REQUIRED: El operador requiere que «idDocument» coincida con cualquier otro atributo.
SUBSCRIBER_MATCH.ID_DOCUMENT_MISMATCH: El operador 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.
OK: La entrada se ha procesado correctamente.
status.message Descripción más detallada del estado.
Campo Descripción Obligatorio
id_document_match Indica si el número de identificación asociado al documento de identidad del cliente coincide con el del sistema del operador. No
given_name_match Indica si el nombre de pila del cliente coincide con el que figura en el sistema del operador. No
family_name_match Indica si el apellido/apellido/apellido del cliente coincide con el del sistema del Operador. No
address_match Indica si la dirección completa del cliente coincide con la del sistema del Operador. No
street_name_match Indica si el nombre de la calle del cliente coincide con el del sistema del Operador. No
street_number_match Indica si el número de la calle del cliente coincide con el que figura en el sistema del operador. No
postal_code_match Indica si el código postal del cliente coincide con el que figura en el sistema del operador. No
locality_match Indica si la localidad de la dirección del cliente coincide con la que figura en el sistema del operador. No
region_match Indica si la región o prefectura del cliente coincide con la que figura en el sistema del operador. No
country_match Indica si el país de la dirección del cliente coincide con el del sistema del Operador. No
house_number_extension_match Indica si la extensión del número de casa de la dirección del cliente coincide con la del sistema de la operadora. No
birthdate_match Indica si la fecha de nacimiento del cliente coincide con la que figura en el sistema del operador. No

Cada uno de estos campos tendrá uno de los siguientes valores:

  • EXACT - el valor proporcionado coincide exactamente.
  • HIGH - El valor proporcionado se aproxima bastante, pero no coincide del todo.
  • 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 - Se ha tenido en cuenta el valor introducido en el campo de entrada a la hora de calcular el address_match campo de respuesta, pero no se ha evaluado de forma independiente.

Lecturas complementarias