API de Verificación de Números de Teléfono en Brasil (ES-1)

Incorporar usuarios en Brasil implica confirmar que son quienes dicen ser. Verifica los datos ingresados con la información de telefonía de los operadores de red móvil. Un documento o un detalle ingresado solo prueban que los datos existen —no que sean genuinos o pertenezcan a la persona que tienes enfrente. La Verificación de Números de Teléfono en Brasil cierra esta brecha al verificar los datos con la información de los operadores de red móvil. Esta guía explica qué hace la verificación, los detalles técnicos exactos y cómo integrarla en minutos.

Puntos clave:

• Qué verifica — La Verificación de Números de Teléfono en Brasil valida la titularidad de los números de teléfono con datos de operadores de red móvil.
• Qué obtienes a cambio — un match_type normalizado más resultados a nivel de campo que puedes enrutar directamente a la lógica de aprobar / revisar / rechazar.
• Por qué es importante — Confirmar que un número de teléfono pertenece a la persona indicada bloquea la apropiación de cuentas y el fraude basado en SIM antes de que comience.
• Cómo usarla — un POST al endpoint de validación de base de datos de Didit. $0.40 por consulta concluyente, resultados en segundos.

Qué valida la Verificación de Números de Teléfono en Brasil

Verifica los datos ingresados con la información de telefonía de los operadores de red móvil. Didit lo expone a través de un único endpoint para que puedas verificar los datos enviados con la información de los operadores de red móvil y recibir un resultado estructurado y normalizado, no un volcado de registro sin procesar que tengas que analizar tú mismo.

Una respuesta concluyente devuelve los source_data coincidentes y un bloque de validation por campo, para que tu motor de riesgo obtenga un veredicto claro y legible por máquina.

Por qué es importante

Confirmar que un número de teléfono pertenece a la persona indicada bloquea la apropiación de cuentas y el fraude basado en SIM antes de que comience.

Para las empresas reguladas en Brasil — fintechs, plataformas de criptomonedas, prestamistas, mercados y operadores de juegos — la verificación con una fuente autorizada produce un registro defendible y auditable que demuestra que la identidad se confirmó en la fuente, no solo que se capturó de un formulario o una foto.

Detalles técnicos

Didit expone este servicio a través del endpoint unificado de validación de base de datos. Es un único POST —no se requiere SDK.

Endpoint

POST /v3/database-validation/

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
issuing_state	string	Sí	Código de país alfa-3 ISO 3166-1. Utiliza BRA.
services	string	Sí	Identificador de servicio. Utiliza bra_phone.
first_name	string	Sí	Nombre.
last_name	string	Sí	Apellido.
address	string	Sí	Dirección.
phone	string	Sí	Teléfono.

Ejemplo de solicitud

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=BRA" \
  -F "services=bra_phone" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "address=123 Sample Street, Sample City, 10001" \
  -F "phone=+15550101000"

Ejemplo de respuesta (coincidencia concluyente)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_phone",
      "service_name": "Brazil - Phone",
      "source_data": {
        "address": "123 Sample Street",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Rendimiento y facturación

• Latencia: normalmente un par de segundos.
• Costo: $0.40 por consulta concluyente. Solo se te factura por los resultados concluyentes — sin cargo por tiempo de inactividad de la fuente, campos faltantes o rechazos previos a la fuente.
• Fiabilidad: funciona en la infraestructura de Didit con un objetivo de tiempo de actividad trimestral del 99.9%.

Casos de uso

• Fintech y neobancos — confirma un titular de cuenta real y verificable antes de abrir una billetera o extender crédito en Brasil.
• Cripto y Web3 — cumple con los requisitos de incorporación de VASP con una prueba de identidad de fuente autorizada.
• Préstamos — reduce el fraude de identidad sintética y el fraude de primera parte con datos verificados en la fuente.
• Mercados y plataformas de trabajos ocasionales — verifica a los usuarios con datos autorizados, no solo con un formulario auto-reportado.
• iGaming — cumple con las verificaciones de identidad y elegibilidad para jugadores de Brasil con un rastro auditable.

Cómo integrarse con Didit

Puedes ejecutar la Verificación de Números de Teléfono en Brasil de dos maneras:

1. Solo API directa. Este servicio se ejecuta a través de la API en lugar del constructor de flujo de trabajo sin código.
2. API directa. Llama al endpoint /v3/database-validation/ que se muestra arriba con services=bra_phone. Lee match_type y el bloque de validation por campo para impulsar tu lógica de aprobar / revisar / rechazar.

Cada cuenta de Didit incluye 500 verificaciones gratuitas por mes, para que puedas probar el flujo completo de principio a fin antes de pagar por una sola consulta.

Preguntas frecuentes

¿Qué confirma la verificación de números de teléfono en Brasil?

Valida los datos enviados con la información de telefonía de los operadores de red móvil y devuelve un resultado de coincidencia normalizado, para que sepas si la titularidad del número de teléfono existe en la fuente autorizada y qué campos coinciden.

¿Qué sucede si la fuente está temporalmente no disponible?

No se te cobrará. La facturación se aplica solo a los resultados concluyentes — el tiempo de inactividad de la fuente, los campos faltantes y los rechazos previos a la fuente son gratuitos.

¿Qué tan rápida es la verificación?

La validación de la base de datos normalmente se devuelve en un par de segundos, por lo que se adapta a un flujo de incorporación en tiempo real.

¿Necesito un SDK?

No. La verificación es un único POST de HTTPS a un endpoint.

¿Listo para comenzar?

Valida la titularidad de tu primer número de teléfono en Brasil hoy mismo.

• Lee la referencia de la API: Verificación de Números de Teléfono en Brasil
• Consulta todas las validaciones de base de datos: Precios y cobertura de la validación de base de datos
• Comienza a construir: Crea una cuenta gratuita de Didit — 500 verificaciones al mes, gratis.