Antigüedad como suscriptor [Versión preliminar para desarrolladores]

La antigüedad del abonado permite verificar que un abonado de la red ha sido cliente del operador de telefonía móvil durante un periodo mínimo determinado, con el fin de establecer un nivel de confianza respecto al identificador de suscripción a la red asociado.

Está diseñado para empresas y proveedores de servicios que necesitan verificar la identidad de los usuarios en línea —especialmente aquellos del sector de los servicios financieros, la tecnología financiera, el comercio electrónico o las telecomunicaciones— y que desean reducir el fraude y mejorar la fiabilidad de la toma de decisiones.

Entre los casos de uso más habituales en los que la antigüedad del suscriptor puede resultar beneficiosa, se encuentran:

• Reforzar la verificación de la identidad y el proceso de alta: Las empresas pueden utilizar la antigüedad del abonado para evaluar la fiabilidad de la identidad móvil de un usuario durante el proceso de alta o la verificación KYC. Una antigüedad prolongada del número de teléfono refuerza la confianza en que la identidad del usuario es auténtica, complementando otros controles, como la verificación de documentos o la coincidencia de datos del abonado. Esto contribuye a reducir el fraude en el proceso de alta y mejora la confianza en la validación de la identidad digital.
• Mejorar la fiabilidad de la autenticación: La API es compatible con autenticadores de teléfono móvil, como la verificación de números o los SMS con contraseña de un solo uso (OTP), al incorporar un factor de confianza basado en el tiempo de antigüedad del número de teléfono. Cuando un número lleva mucho tiempo activo, se le puede dar prioridad o asignarle un mayor peso en los modelos de puntuación de riesgo, mientras que los números activados recientemente pueden activar una autenticación reforzada.
• Mejorar la detección del fraude y la puntuación de riesgo: Los sistemas de prevención del fraude pueden utilizar los datos sobre la antigüedad de las líneas para identificar números de teléfono recién activados o de corta duración que puedan indicar identidades sintéticas o actividades de alto riesgo. Esto permite la detección temprana de posibles fraudes antes de que afecten a las transacciones, a los cambios en las cuentas o a otras operaciones sensibles.
• Evaluación de riesgos de los servicios financieros: Los bancos y las entidades financieras pueden integrar las comprobaciones de antigüedad en sus procesos de concesión de préstamos y de pagos. Al evaluar el tiempo que un usuario lleva con el mismo número de teléfono, obtienen un indicador adicional de credibilidad y estabilidad, lo que contribuye a reducir la probabilidad de que se produzcan fraudes de identidad o Applications falsas.

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.

En esta guía se explica cómo utilizar la herramienta «Subscriber Tenure Insight» mediante programación con cURL.

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 la métrica «Antigüedad del abonado», con el fin de comprobar si el abonado asociado al número de teléfono indicado ha mantenido su relación con el mismo operador durante todo el periodo analizado; el inicio del periodo analizado viene definido por el date parámetro:

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
        	"subscriber_tenure": {
          "date": "2023-07-03"
          }
        }
    }'

A continuación, la API recuperará la información sobre la antigüedad asociada a ese número de teléfono móvil concreto y la validará comparándola con la fecha facilitada en la solicitud:

{
    "request_id": "f41087de-b9fc-4081-ab85-9d6475a19706",
    "insights": {
        "subscriber_tenure": {
            "is_tenure_met": true,
            "contract_type": "PREPAID",
            "status": {
                "code": "OK",
                "message": "Success"
            }
        }
    }
}

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

Si status.code en la respuesta se indica que OK, también es posible que aparezcan los campos descritos en la tabla siguiente. Si un campo aparece marcado como «Sí» en la columna «Obligatorio», siempre se mostrará cuando el estado sea «OK». Si un campo aparece marcado como «No», puede que se muestre o puede que no.

Lecturas complementarias

• Para obtener más información sobre la API de Identity Insights, consulta la Referencia API.
• Si tiene alguna pregunta, puede ponerse en contacto con nosotros en el Comunidad de Vonage Slack.