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.

Nota: El uso de este insight en producción requiere la aprobación de los operadores de telefonía móvil, que se gestiona a través del "Registro de redes". Para saber cómo solicitar acceso, siga 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 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"
      }
    }
  }
}

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 para 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 y apellidos del cliente coinciden con los del 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 del sistema del Operador. No
postal_code_match Indica si el código postal del cliente coincide con el del sistema del Operador. No
locality_match Indica si la localidad de la dirección del cliente coincide con la del sistema del Operador. No
region_match Indica si la región o prefectura del cliente coincide con la del 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 del 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 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.

Lecturas complementarias