Guía de verificación y riesgo
Verificación y riesgo de transacciones sirve para comprobar a tus clientes y sus transacciones, con cobro por verificación desde el saldo de la cuenta:
- Seis tipos de verificación: verificación personal, verificación empresarial, monitoreo de transacciones, análisis de billetera, análisis AML y riesgo en el registro
- Se empieza a usar pulsando «Habilitar» en el «Panel»; la activación es gratis, sin cuota mensual ni gasto mínimo
- Si la solicitud no fue aceptada o se confirma que falló, se reembolsa automáticamente; si la verificación venció o ya hay un resultado, no se reembolsa
- El «Historial de verificaciones» se puede filtrar, buscar y exportar, y el detalle muestra el resultado de cada etapa y el estado del cobro
- Puedes configurar el callback de resultados o iniciar verificaciones desde tu propio sistema con una clave API de la plataforma
Qué hace este servicio
Verificación y riesgo de transacciones sirve para comprobar a tus clientes y sus transacciones: verificar la identidad de personas o empresas, evaluar el riesgo de una transacción antes o después de una transferencia, analizar direcciones de billetera y listas, y evaluar el riesgo del correo, el teléfono o la IP cuando un cliente se registra.
- Verificación personal — La persona verificada completa con su celular la foto del documento, la prueba de vida y la comparación facial.
- Verificación empresarial — Revisa el registro mercantil, los documentos de la empresa y las personas clave.
- Monitoreo de transacciones — Evalúa el riesgo de una transacción, por separado para transacciones fiat y cripto; en las transacciones cripto también analiza las direcciones en la cadena.
- Análisis de billetera — Analiza por sí solo el riesgo de una dirección de billetera y si coincide con listas de sanciones.
- Análisis AML — Analiza un nombre de persona o de empresa contra listas de PEP, de sanciones y de alertas regulatorias, con resultado al instante.
- Riesgo en el registro — Evalúa el riesgo de un correo, un número de teléfono o una IP, por ejemplo correos desechables, números virtuales, VPN e IP de centros de datos.
Los resultados son solo orientativos: la plataforma no congela ni rechaza fondos automáticamente por ellos. La plataforma solo guarda los resultados, puntuaciones y coincidencias de cada etapa, no nombres, números de documento ni imágenes de documentos. Este servicio no tiene entorno de pruebas: cada verificación es real y se cobra de verdad.
Activación
En «Verificación y riesgo de transacciones → Panel», pulsa «Habilitar». La activación no cuesta nada y no hace falta ingresar ninguna cuenta ni clave. La tarjeta de activación lista el precio de cada tipo de verificación; los tipos marcados como «Aún no disponible» no se pueden usar por ahora.
- Después de activarlo, en «Configuración de integración» puedes configurar, según lo necesites, la página de traspaso, el callback de resultados y la API abierta; se explica más abajo.
- Cada verificación se cobra del saldo de la cuenta; antes de iniciarla, confirma que tengas saldo suficiente.
Cobro y reembolsos
Se cobra por verificación desde el saldo de la cuenta, sin cuota mensual ni gasto mínimo. El precio unitario aparece en las tarjetas de entrada del «Panel», en la página para iniciar y en el cuadro de confirmación del cobro; lo que cuenta es lo que muestra la página. El monitoreo de transacciones tiene dos precios, fiat y cripto, y el riesgo en el registro tiene un precio distinto para correo, teléfono e IP.
- La solicitud no fue aceptada — Se reembolsa automáticamente y el registro muestra «Fallida».
- El registro muestra «Verificando resultado» — El sistema lo verifica automáticamente; si se confirma que falló, se reembolsa automáticamente.
- La persona verificada no la completó, o la verificación venció — No se reembolsa.
- Ya hay un resultado (incluidos «Rechazada», «En revisión» y «Sin evaluar») — No se reembolsa.
- Se vuelve a iniciar con una referencia del sujeto que todavía tiene una verificación sin terminar — No se cobra de nuevo: se abre directamente la verificación anterior.
La verificación empresarial se liquida en dos pasos: al iniciarla se cobra por adelantado según el número de beneficiarios finales indicado en la página, y cuando llega el resultado se liquida según el número real de beneficiarios finales y el país de registro de la empresa, devolviendo lo cobrado de más o cobrando lo que falte; el detalle del registro incluye el desglose del cobro.
Iniciar una verificación personal o empresarial
- Escribe la referencia del sujeto: En «Verificación y riesgo de transacciones → Verificación de identidad → Verificación personal» o en «Verificación empresarial», escribe el identificador único de este sujeto en tu sistema, o pulsa «Elegir del directorio». La referencia solo puede contener letras, dígitos y . _ : @ + -, debe tener entre 1 y 128 caracteres y empezar con una letra o un dígito.
- Confirma el cobro: Pulsa «Iniciar verificación», revisa el tipo de verificación y el precio en el cuadro de confirmación y pulsa «Confirmar y cobrar».
- Entrega el enlace a la persona verificada: La página te da un enlace de verificación y un código QR: puedes usar «Copiar enlace» y enviárselo a la persona verificada, o pedirle que use «Escanear con el teléfono». El enlace sirve solo para esta verificación y deja de funcionar cuando se completa o vence.
- Espera el resultado: La persona verificada primero lee y acepta el aviso, y después completa la captura con su celular. La página muestra el avance como «Creada», «Aviso aceptado», «Verificando» y «Resultado», y se actualiza sola.
Al abrir el enlace, lo primero que ve la persona verificada es la página de traspaso: quién la invita a verificarse y qué documentos tiene que leer y aceptar. En «Página de traspaso», dentro de «Configuración de integración», puedes definir el nombre del solicitante que aparece en la página (hasta 60 caracteres) y los enlaces a tu propia política de privacidad y a tus términos de servicio (los dos enlaces van juntos y deben ser https); las páginas siguientes, para fotografiar el documento y tomarse la selfie, tienen el diseño unificado de la plataforma.
Control de riesgo de transacciones
«Verificación y riesgo de transacciones → Control de riesgo de transacciones» tiene cinco pestañas. Completa los datos y pulsa «Ejecutar verificación»: la página te da un informe con la puntuación de riesgo, el resultado y las reglas que se activaron.
- Transacción fiat — La referencia y el nombre de la parte, el sentido (entrada o salida), el monto y la moneda. El nombre de la parte solo se usa para el análisis; la plataforma no lo guarda en texto claro.
- Transacción cripto — La parte, el sentido, la red y el activo, el monto y la dirección de la contraparte; en las entradas que ya están en la cadena puedes indicar el hash de la transacción y tu propia dirección de recepción. Redes admitidas: TRON, Ethereum, BNB Chain, Polygon, Solana y Bitcoin.
- Dirección de billetera — La red y la dirección de billetera; analiza por sí solo el riesgo de esa dirección y si coincide con listas de sanciones.
- Análisis AML — Persona o empresa, y el nombre o la razón social; la fecha de nacimiento y la nacionalidad son opcionales y ayudan a reducir los falsos positivos por nombres iguales. La plataforma no guarda ese nombre.
- Riesgo en el registro — Uno de tres: correo, número de teléfono o dirección IP. Puedes escribir la referencia que le diste a este cliente: si el mismo correo o número aparece en otro de tus clientes, se te avisa; el registro solo conserva el valor enmascarado.
El análisis de billetera, el análisis AML y el riesgo en el registro dan el resultado al instante, y volver a consultar se cobra de nuevo. En el análisis AML y el riesgo en el registro, «Requiere revisión» significa que puede haber una coincidencia con una lista o una señal de riesgo; ese resultado ya no cambia, y debes valorarlo tú según tu negocio.
Ver resultados y el historial de verificaciones
El «Historial de verificaciones» lista todas las verificaciones; se pueden filtrar por tipo, estado y resultado, buscar por referencia, dirección o número de cobro, y «Exportar» a CSV con el filtro actual (hasta 5000 registros). Al abrir un registro ves el resultado de cada etapa, la puntuación de riesgo, el número de cobro y el estado del cobro. En «Directorio», «Usuarios» y «Empresas» agrupan por referencia del sujeto las verificaciones que iniciaste.
- Recibida / Esperando a la persona / En proceso — La verificación sigue en curso.
- Verificando resultado — El resultado no está claro y el sistema lo está verificando; si se confirma que falló, se reembolsa automáticamente.
- Fallida — La verificación no se completó y el cobro ya se devolvió.
- Aprobada / Rechazada / En revisión — El resultado de la verificación. «En revisión» significa que está en revisión manual: el resultado puede cambiar y se actualiza automáticamente cuando termina.
- Sin evaluar — No hay datos disponibles sobre este sujeto, así que no se dio una evaluación de riesgo; eso no significa que sea seguro.
- Vencida — La persona verificada no completó la verificación dentro del plazo.
- El reembolso se ve en tres lugares: la columna «Cargo» del historial muestra «Reembolsado», el «Estado del cobro» del detalle aparece como «Reembolsado», y en las facturas de «Finanzas» está el reembolso correspondiente.
- Las verificaciones y el gasto del mes que muestra el «Panel» se cuentan por mes calendario UTC y no incluyen las verificaciones reembolsadas.
- En la verificación personal, la verificación empresarial y el monitoreo de transacciones puedes actualizar el resultado desde el detalle del registro; actualizar no cobra nada.
Callback de resultados y API abierta
- En «Callback de resultados», dentro de «Configuración de integración», escribe una URL de callback https y actívalo. Cuando cambia el estado o el resultado de un registro, la plataforma envía a esa URL un evento firmado por POST; si el destino no devuelve un 2xx, se reintenta con espera progresiva, hasta 8 veces.
- El secreto de firma solo se muestra una vez, al generarlo. Úsalo para verificar el encabezado X-Tovanix-Signature: su valor es sha256= seguido del hexadecimal de HMAC-SHA256(secreto de firma, marca de tiempo + "." + cuerpo original de la solicitud), y la marca de tiempo va en X-Tovanix-Timestamp. Al pulsar «Generar un secreto nuevo», el secreto anterior deja de funcionar de inmediato.
- Puedes pulsar «Enviar evento de prueba» para comprobar la conexión; en «Entregas recientes» ves el resultado de cada entrega.
- API abierta: al crear una clave en «Mi cuenta → Gestión de API», marca el permiso «Verificación y riesgo» para poder iniciar verificaciones y consultar registros desde tu propio sistema. Los precios son los mismos que en la consola, y al iniciar una verificación hay que enviar una clave de idempotencia.
Solución de problemas
- Al iniciar aparece que el saldo es insuficiente — El saldo de la cuenta no alcanza para el precio de esta verificación — Esta vez no se cobró nada; recarga y vuelve a intentarlo.
- Al iniciar aparece que el servicio de verificación rechazó la solicitud — La solicitud no fue aceptada — El cobro se devuelve automáticamente y la columna «Cargo» del historial muestra «Reembolsado». Revisa los datos que escribiste y vuelve a iniciarla.
- El registro sigue mostrando «Verificando resultado» — El resultado no está claro y el sistema lo sigue verificando — Espera a la verificación automática; si no cambia durante mucho tiempo, contacta a soporte e incluye el ID del registro.
- Al abrir el enlace, la persona verificada ve «Enlace de verificación no disponible» — El enlace venció o esta verificación ya terminó — Inicia una nueva verificación y envía el enlace nuevo; iniciarla de nuevo vuelve a cobrarse.
- Falla la verificación de la firma del callback — La firma no se calculó con el cuerpo original de la solicitud, o el secreto de firma se regeneró — Calcula la firma con el cuerpo original tal como lo recibiste, sin analizarlo y volver a serializarlo antes; después de generar un secreto nuevo, actualiza también el secreto en tu sistema.
Preguntas frecuentes
Si la verificación vence o el resultado es «Rechazada», ¿se reembolsa el cobro?
No. La verificación se cobra al iniciarla, y no se reembolsa si la persona verificada no la completa, si vence o si el resultado es «Rechazada»; solo se reembolsa automáticamente cuando la solicitud no fue aceptada o cuando se confirma que falló.
Si el resultado es «Rechazada», ¿la plataforma congela los fondos?
No. Los resultados son solo orientativos: la plataforma no congela ni rechaza fondos automáticamente por ellos; tú decides si dejas pasar la operación.
¿Se puede integrar por API?
Sí. Crea una clave en «Mi cuenta → Gestión de API» y marca el permiso «Verificación y riesgo»; el callback de resultados se configura en «Configuración de integración».
Páginas relacionadas: Centro de ayuda · Guías y preguntas frecuentes · Verificación y riesgo de transacciones · API de Verificación y riesgo de transacciones
Cargando…