Saltar al contenido principal

Cómo funciona

Una verificación es una solicitud de entrada y un veredicto de salida. Esta página sigue ese recorrido de principio a fin, para que sepas qué ocurre entre ambos y en qué puedes apoyarte más adelante.

El recorrido de una verificación​

  1. Tu backend envía una verificación. Una verificación de dirección o una verificación de transacción, autenticada con una clave de API.
  2. La solicitud se admite o se rechaza de entrada. La clave, su scope, el límite de solicitudes y la cuota o el saldo prepagado se comprueban antes de empezar el cribado. Una solicitud rechazada responde con un error y nunca se cobra.
  3. El motor de cribado reúne hallazgos. Contrasta la dirección con listas oficiales públicas y con el conjunto propio de etiquetas de Leeri, sigue los fondos a través de las contrapartes de la dirección en los activos con cobertura completa y usa una fuente de datos de terceros cuando hay una disponible. Cada hallazgo nombra su fuente.
  4. El veredicto se deriva y se fija. Un ruleset publicado pondera los hallazgos en una puntuación y un nivel de riesgo. El veredicto registra la versión del ruleset, la instantánea de etiquetas y la altura de la cadena con las que se derivó, de modo que pueda reproducirse después.
  5. Recibes la respuesta, un informe y, si lo registraste, un webhook. La respuesta lleva el veredicto. Un informe de evidencias del veredicto está incluido en la verificación, y un webhook entrega check.completed cuando la verificación es definitiva.

Síncrona o pending​

La mayoría de las verificaciones responde en la misma respuesta. Cuando una necesita más tiempo del que debe retener una solicitud, la API la acepta y responde status: "pending" con la misma forma de cuerpo y un check_id. El veredicto se produce en segundo plano. Lee el resultado con sondeo o, mejor, con un webhook: consulta Pending y sondeo. Una verificación pending aún no tiene veredicto, no se cobra y no envía el webhook de finalización; todo se liquida una sola vez, cuando termina.

Veredictos parciales​

Si una fuente de datos no está disponible, la verificación no falla con un error de servidor ni finge estar limpia. Devuelve un veredicto parcial que dice que lo es y enumera los motivos. Un veredicto parcial causado por una caída no se cobra y puedes repetir la verificación más tarde. Un veredicto parcial que solo expresa un límite del análisis, como la profundidad del recorrido en un activo, es el servicio completo para esa dirección y se cobra. Las reglas de cobro están en Límites de solicitudes y cuotas y los campos en Verificaciones de dirección.

Sandbox y live​

El entorno lo elige la clave. Una clave sandbox ejecuta el mismo motor sobre tus propios datos sin consumir cuota ni saldo, con un límite de solicitudes más bajo, y tiene una dirección de prueba designada que siempre responde pending. Una clave live se cobra. Al cambiar no varía nada más. Consulta Sandbox y live.

Qué almacena Leeri y por qué​

Un veredicto se almacena como sus hallazgos y las referencias a la evidencia que los respalda, junto con el pin, y no como un número suelto. Eso es lo que hace que un veredicto sea explicable y reproducible meses después: Rederive lo reproduce con el ruleset y la instantánea de etiquetas con los que se emitió, y el informe de evidencias puede comprobarse como auténtico. Las respuestas de fuentes de datos de terceros pasan a ser entradas con fuente en el conjunto propio de etiquetas de Leeri; con ellas no se almacena nada sobre tu cuenta, tus clientes ni tu verificación.

Siguiente​