Uso de CertivantHerramientas de flujoDiseñar una política de riesgo

Diseñar una política de riesgo

Use el diseñador visual de políticas de flujo de trabajo de Certivant para crear reglas de decisión KYC/KYB personalizadas (condiciones, umbrales y resultados de aprobar, rechazar o escalar) y, después, simule y publique políticas versionadas.

Who can do this:Org ownerOrg admin— Requiere el plan Pro o superior (la función kyc.policy_builder). En planes inferiores, el elemento del menú muestra una insignia «Requiere Pro» y abre un aviso de mejora de plan.

La página de Políticas de verificación de identidad, con los recuentos de políticas activas, borradores y archivadas, y la acción Nueva política.

Qué hace

El Diseñador de políticas de flujo de trabajo le permite decidir cómo se aprueba, se rechaza o se envía a revisión manual una verificación, de forma visual y sin código. Arrastra bloques de reglas a un lienzo, define condiciones sobre las señales que genera cada verificación (puntuación de confianza, coincidencia con sanciones, comprobaciones de documentos, país del solicitante, riesgo de red, prueba de cámara en vivo y otras) y los conecta a los resultados Aprobar, Rechazar, Escalar o Requerir verificación en vivo.

Cada organización empieza con una política predeterminada integrada que reproduce exactamente la decisión estándar de puntuación de confianza de 17 factores de Certivant. Por tanto, activar la función no cambia nada hasta que decida personalizarla: sus resultados actuales se mantienen idénticos.

La política predeterminada es byte a byte equivalente al evaluador estándar. Puede verla, clonarla y editar la copia; la original sigue funcionando hasta que publique su propia versión.

Antes de empezar

  • Su plan debe incluir el Diseñador de políticas de flujo de trabajo (Pro o superior). Si el elemento Políticas de flujo de trabajo del menú Desarrollador muestra la insignia «Requiere Pro», pida al propietario de la cuenta que mejore el plan; consulte Facturación y créditos.
  • Debe entender cómo se puntúa una verificación, para saber en qué señales escribir sus reglas. Consulte Revisar solicitudes de verificación.
  • Publicar una política cambia cómo se deciden las verificaciones futuras de toda su organización. No vuelve a decidir las solicitudes anteriores.

Conceptos clave

  • Nodos: los bloques del lienzo. Un nodo Inicio comienza el flujo; los nodos Condición contienen las reglas; los nodos Fin son los resultados (Aprobada / Rechazada / Escalada / Revisión manual / Requerir verificación en vivo / Traspasar a otra política). Los nodos de acción (Formulario, Validación de ID, Correo electrónico, SMS, Webhook, Conferencia en vivo) documentan los pasos de orquestación alrededor de la decisión; para ejecutar pasos, use los Flujos de trabajo de automatización.
  • Condiciones: un nodo de Condición evalúa las señales de la verificación, por ejemplo overallScore >= 75, sanctions.isMatch = true, applicant.country IN ["IR","KP","SY"] o redFlags CONTAINS "network_vpn_detected". Puede combinar pruebas con Y / O / NO y anidar grupos, incluidas las condiciones encadenadas tras otras condiciones en el lienzo.
  • Gana la primera coincidencia: las reglas se evalúan de arriba abajo desde el Inicio; la primera Condición cuya prueba sea verdadera aporta la decisión. Una regla final captura todo lo demás (falla de forma segura a Escalar, nunca a una aprobación silenciosa).
  • Motivos: asigne a una condición un motivo (por ejemplo, «País de alto riesgo»). Se registra junto con la decisión, de modo que el revisor ve por qué se escaló la solicitud, no solo qué regla se activó.
  • Versiones: cada política guardada es un borrador hasta que la publica. Al publicarla, esa versión queda congelada (es inmutable) y pasa a estar activa; la versión activa anterior de esa política se archiva. Para cambiar una política publicada, haga clic en Nueva versión; así siempre dispone de un historial completo y auditable.
  • Dónde se aplica: una política publicada decide las solicitudes de todos los formularios que la fijan. Si la convierte en la política predeterminada de la organización, decidirá también el resto de solicitudes, incluidas las creadas mediante la API. Si no hace ninguna de las dos cosas, decide la política predeterminada integrada de Certivant.

Pasos

Abrir las Políticas de flujo de trabajo

Haga clic en Desarrollador → Políticas de flujo de trabajo en la barra lateral izquierda. Se abre el panel de Políticas de flujo de trabajo: tarjetas de estadísticas (activas / borradores / archivadas / versiones totales) sobre una tabla con todos los flujos guardados. Cada fila es una política versionada; la activa es la que decide actualmente sus verificaciones.

Abrir o crear un flujo de trabajo

El editor de lienzo de políticas, con la política predeterminada integrada: el enlace Políticas, el nombre de la política, la versión y la insignia Activa, el desplegable Cargar política, el aviso de solo lectura y el flujo de condiciones que conduce a Rechazada, Escalada y Aprobada.

Haga clic en el nombre de un flujo de la tabla para abrirlo en el editor de lienzo, o en Nuevo workflow para empezar uno nuevo basado en la plantilla predeterminada de la plataforma. Asígnele un nombre claro (campo superior izquierdo): es lo que volverá a escribir más adelante para confirmar la publicación. Use el enlace ← Políticas para volver al panel, o el desplegable Cargar política para cambiar de versión sin salir del lienzo.

Añadir y configurar una condición

Arrastre un bloque Condición desde la paleta al lienzo y haga clic en él para seleccionarlo; sus ajustes se abren en la pestaña Propiedades del panel derecho (así el lienzo sigue siendo totalmente arrastrable). Construya la prueba con el generador visual:

  • Campo: elija una señal (por ejemplo, overallScore, sanctions.isMatch, applicant.country, checks.liveness.confidence).
  • Operador: =, !=, >, >=, <, <=, IN / NOT IN una lista, o CONTAINS / NOT CONTAINS (una lista contiene un valor, o un texto contiene una palabra).
  • Valor: un número, un texto, true/false o una lista de valores. Para redFlags, notices, reviewTriggers y disqualifiers, el cuadro de valor sugiere los códigos que usa Certivant.
  • Y / O / NO: añada grupos anidados para la lógica compuesta.

La lista de campos abarca todas las señales de Señales que puede probar más abajo.

¿Prefiere escribir reglas directamente? Active la pestaña DSL sin procesar en el editor de condiciones para escribir la expresión directamente: se sincroniza con el generador visual, y una insignia roja señala cualquier error de sintaxis.

Conectar los resultados

Dibuje una conexión desde la rama Sí (verdadero) de la condición hasta el nodo Fin de la decisión que debe producir (Aprobar / Rechazar / Escalar / Requerir verificación en vivo), y encadene la rama No (falso) con la siguiente condición. La regla final lleva al resultado predeterminado.

Para traspasar a otra política, elija el resultado Delegar de un nodo Fin y seleccione una de sus políticas activas; entonces, la otra política decide. Una política no puede traspasarse a sí misma.

Simular antes de publicar

Abra el panel Vista previa. Muestra el YAML (y el AST) en vivo de su política. Cambie a Simular, pegue una carga de verificación de ejemplo (o modifique el ejemplo) y ejecútela. Verá la decisión resultante, las reglas que se activaron y una traza por regla que indica qué fila ganó, asignada al nodo correspondiente del lienzo. Cuando una regla traspasa a otra política, el resultado muestra también la decisión final y la cadena de políticas por la que pasó.

Guarde el borrador una vez (paso siguiente) para habilitar Simular. A partir de ahí, se ejecuta lo que hay en el lienzo, incluidos los cambios sin guardar, exactamente como lo haría el motor en vivo.

Guardar el borrador

Haga clic en Guardar borrador. Se guardan tanto la disposición del lienzo como las reglas compiladas. Los borradores son totalmente editables y no afectan a las verificaciones en vivo.

Publicar para activar

Haga clic en Publicar. Un diálogo de confirmación le pide que vuelva a escribir el nombre de la política para activar el botón; es deliberado, porque publicar:

  • congela esta versión (ya no puede editarse), y
  • la convierte en la versión activa de esta política, archivando la versión activa anterior.

Los formularios que fijan esta política usan la nueva versión de inmediato. Las solicitudes existentes no se ven afectadas.

Elegir dónde se aplica

  • En un formulario: en los ajustes del formulario, elija esta política como su política de decisión. Solo las solicitudes de ese formulario la usarán.
  • En el resto de casos: haga clic en Usar para todas las solicitudes en la barra del editor. El botón se convierte en Predeterminada de la organización y la política pasa a decidir cada solicitud cuyo formulario no fije una política, incluidas las solicitudes de la API. Vuelva a hacer clic para volver a la predeterminada integrada.

La lista de políticas marca con una insignia la política predeterminada de la organización.

Qué activa su política

Una política de flujo de trabajo se ejecuta automáticamente: no hay ningún botón de «ejecutar» y no se activa a mano. Dos cosas la arman y la disparan:

  1. Publicar la arma. Al publicar una política, esa versión pasa a estar activa (una sola versión activa por política; al publicar se archiva la anterior). Decide las solicitudes de todos los formularios que la fijan, y también todas las demás solicitudes una vez que la convierte en la predeterminada de la organización.
  2. Cada nueva verificación la dispara. Cada vez que se ejecuta una verificación (un solicitante envía sus documentos, usted envía una solicitud de verificación o un revisor pulsa Volver a verificar), Certivant ejecuta la cadena completa de comprobaciones (OCR, biométricos, sanciones, fraude, comprobaciones de red y de captura, la puntuación de confianza de 17 factores) y después entrega los resultados a la política que decide. El veredicto de la política (Aprobar / Rechazar / Escalar / Requerir verificación en vivo) pasa a ser el estado final de la solicitud.

Qué política decide una solicitud, por orden:

  1. la política que fija su formulario;
  2. si no, la política predeterminada de su organización;
  3. si no, la predeterminada integrada de Certivant.

Una política fijada o predeterminada sin versión activa (por ejemplo, si la archivó) recurre a la predeterminada integrada, nunca a otra política.

flowchart LR
    A[Applicant submits<br/>verification] --> B[Checks run:<br/>OCR · biometrics ·<br/>sanctions · fraud]
    B --> C[17-factor<br/>trust score]
    C --> D{Active policy<br/>evaluates the<br/>score + signals}
    D -->|first matching rule| E[Approve]
    D --> F[Reject]
    D --> G[Escalate to<br/>manual review]

Si no ha publicado una política personalizada, se ejecuta la política predeterminada integrada; así, cada verificación siempre la decide alguna política. Activar la función no cambia nada hasta que publique su propia versión.

Publicar afecta solo a las verificaciones futuras. No vuelve a ejecutar ni a decidir de nuevo las solicitudes ya completadas: estas conservan la decisión tomada por la política que estaba activa en ese momento. Para volver a decidir una solicitud concreta con la nueva política, ábrala y use Volver a verificar.

Cómo cambia sus verificaciones

Tras publicar, cada nueva verificación la decide su política activa en lugar de la predeterminada integrada. Para cada solicitud, Certivant registra:

  • el id, el nombre y la versión de la política que la decidió, y
  • la lista de reglas que se activaron,

tanto en el registro de auditoría de la solicitud como en la carga útil del webhook (data.policy en kyc.request.approved / rejected / escalated). Así, sus sistemas posteriores pueden ver qué política y qué reglas impulsaron cada decisión. Consulte Webhooks.

Cuando una salvaguarda posterior cambia el resultado de la política (una solicitud KYB que todavía espera su comprobación en el registro, o una solicitud en modo de prueba), el registro de auditoría recoge esa anulación y el estado final, de modo que el registro nunca muestra una decisión que no llegó a prevalecer.

Requerir verificación en vivo

Elija Requerir verificación en vivo como resultado de un nodo Fin para enviar una solicitud a una videollamada en lugar de decidirla solo con los documentos; por ejemplo, cuando la puntuación está en el límite, el solicitante usa una VPN o no se pudo demostrar que la selfie proviene de una cámara en vivo:

overallScore >= 60 AND overallScore < 80 → Require live verification
network.vpn = true OR capture.tokenMismatch = true → Require live verification

La solicitud pasa a Escalada, y su página muestra un aviso de Verificación de identidad en vivo requerida con el motivo de la regla, para que su equipo sepa que debe reservar la llamada. La carga útil del webhook incluye data.policy.decision = "live_verification" y liveVerificationRequired: true.

Para reservar la llamada automáticamente, añada un Flujo de trabajo de automatización con el disparador Verificación en vivo requerida y la acción Programar una verificación de identidad en vivo. Cuando el anfitrión registra una decisión durante la llamada, la solicitud se aprueba o se rechaza y se disparan los eventos habituales de aprobación o rechazo. Si se vuelve a verificar después, la política puede leer el resultado de la llamada (por ejemplo, liveVerification.hostDecision = "approved"), de modo que una regla puede aprobar una solicitud que superó su comprobación en vivo.

Señales que puede probar

Además de la puntuación de confianza y de los resultados por comprobación (checks.*, sanctions.*, document.*, applicant.*), una condición puede leer:

ÁreaCampos
Rednetwork.detected, network.vpn, network.proxy, network.tor, network.hosting, network.relay, network.country, network.realNetworkRevealed, network.realNetworkCountry
Prueba de cámara en vivocapture.liveCamera, capture.signals, capture.tokenMismatch, capture.locationRefused
Fraudefraud.signals, fraud.duplicateDocument, fraud.duplicateDevice, fraud.duplicateIp, fraud.duplicatePhone, fraud.duplicateEmail, fraud.velocityExceeded, fraud.blocklistMatch, fraud.blocklistKinds (qué tipos coincidieron con su lista de bloqueo, por ejemplo fraud.blocklistKinds CONTAINS "ip")
Lectura de documentosdocument.secondOpinion.used, document.secondOpinion.disagreed, document.readConfidence, document.daysUntilExpiry, document.tooOld, document.dateUnverifiable, document.dlNumberMismatch (el número del permiso de conducir no encaja con el apellido y la fecha de nacimiento del titular; consulte Señales de fraude)
Correcciones y código de barrascorrections.manual, corrections.fields, barcode.read, barcode.mismatches
Comprobación de edadage.checked, age.result (pass / fail / inconclusive), age.method (estimate / id_document / none), age.estimatedAge (una estimación a partir de la selfie, no una prueba de edad), age.minimum, age.meetsMinimum, age.mismatch. Consulte Comprobación de edad
Solicitanteapplicant.age, applicant.highRiskSources
Sancionessanctions.pep, sanctions.adverseMedia
KYBkyb.status, kyb.representativeMatch, kyb.directorSanctionsHit
Verificación de identidad en vivoliveVerification.held, liveVerification.requested, liveVerification.status, liveVerification.hostDecision, liveVerification.completed, liveVerification.applicantAttended, liveVerification.absentCount, liveVerification.guestCount, liveVerification.coHostCount, liveVerification.observerCount, liveVerification.recorded, liveVerification.applicantNetworkRisk, liveVerification.durationMinutes
CódigosredFlags, notices, reviewTriggers, disqualifiers: listas de códigos, que se prueban con CONTAINS

Un campo que la solicitud no tiene (sin llamada celebrada, sin código de barras leído…) nunca coincide, ni siquiera con !=, NOT IN o NOT CONTAINS. Así, document.issuingCountry != "US" es falso cuando no se leyó ningún documento, en lugar de ser verdadero de forma silenciosa.

Opciones y campos

ConceptoValoresNotas
Resultados de decisiónapprove, reject, escalate, live_verification, delegateescalate envía la solicitud a revisión manual; live_verification escala y marca que se necesita una videollamada; delegate traspasa a otra política activa. Un resultado «personalizado» también escala.
Operadores= (o ==) != > >= < <= IN NOT IN CONTAINS NOT CONTAINSLas señales que faltan nunca provocan un error: simplemente no coinciden, ni siquiera en una prueba negativa.
Lógica booleanaAND, OR, NOT, grupos anidadosAND tiene prioridad sobre OR.
Estado de la políticadraft, active, archivedSolo una versión puede estar active por política a la vez.
Versionadoinmutable al publicarNueva versión copia una política publicada en el siguiente borrador; el historial se conserva.
Política predeterminada de la organizaciónuna política activa, o ningunaDecide cada solicitud cuyo formulario no fija una política, incluidas las solicitudes de la API. Ninguna = la predeterminada integrada.
Nombre reservadodefault-kyc-policyNombre de la política predeterminada integrada; sus propias políticas no pueden usarlo.

Solución de problemas

No veo «Políticas de flujo de trabajo» en el menú

Está en el menú Desarrollador y es una función Pro. Si el elemento Políticas de flujo de trabajo muestra la insignia «Requiere Pro», su plan no la incluye; pida a su propietario que mejore el plan en Facturación y créditos. Si el menú Desarrollador no aparece en absoluto, es posible que no sea administrador ni propietario; si el elemento simplemente desapareció, actualice la página: la comprobación del plan se guarda en caché durante unos minutos.

No puedo editar una política: los campos están bloqueados

Las versiones publicadas son inmutables por diseño. Abra la versión y haga clic en Nueva versión en la barra: copia la política en el siguiente borrador editable. Haga los cambios y publique; la versión anterior seguirá decidiendo hasta que lo haga.

El botón Simular está desactivado

Simular necesita que la política se haya guardado al menos una vez. Haga clic en Guardar borrador; a partir de ahí, Simular ejecuta lo que hay en el lienzo, incluidos los cambios sin guardar.

Mi política publicada no decide nada

Una política publicada solo decide las solicitudes de los formularios que la fijan. Fíjela en el formulario (ajustes del formulario → Política de decisión), o haga clic en Usar para todas las solicitudes en el editor para convertirla en la predeterminada de la organización.

Una solicitud se escaló con «Verificación de identidad en vivo requerida»

Su política coincidió con una regla de Requerir verificación en vivo; el aviso de la solicitud muestra el motivo de la regla. Reserve una llamada en vivo desde la página de la solicitud, o automatícelo con un flujo de trabajo (consulte Requerir verificación en vivo).

Una condición muestra una insignia roja de «no válida»

La expresión no se pudo analizar. Abra la condición, revise el nombre del campo y el operador, y confirme que los valores de lista están separados por comas. La pestaña DSL sin procesar muestra el mensaje exacto del analizador.

¿Cómo disparo mi flujo de trabajo / cuándo se ejecuta?

No se dispara manualmente. Una vez que está publicada y fijada en un formulario (o convertida en la predeterminada de la organización), se ejecuta automáticamente en cada nueva verificación que cubre: cuando un solicitante envía sus documentos, cuando usted envía una solicitud de verificación o cuando un revisor pulsa Volver a verificar. Consulte Qué activa su política.

Publiqué, pero no pasa nada

Hay tres causas habituales. Primero, una política solo decide las verificaciones que se ejecutan después de activarse; las solicitudes existentes y ya completadas no cambian (consulte más abajo). Inicie una nueva verificación (o use Volver a verificar en una existente) para ver cómo la decide su política. Segundo, confirme que la versión que editó aparece con el estado activa en la tabla del panel: guardar un borrador no la activa; debe publicarla. Tercero, compruebe que el formulario de la solicitud fija la política, o que la política es la predeterminada de la organización.

Publicar no cambió nada en una solicitud en curso

Las políticas solo deciden verificaciones nuevas. Una solicitud que ya se envió conserva la decisión de la política activa en ese momento. Vuelva a ejecutarla solo si pretende volver a decidirla: abra la solicitud y use Volver a verificar.

Historial de versiones, restauración y pruebas A/B

Cada guardado de una política publicada inicia una nueva versión en borrador; Publicar la congela como versión inmutable y archiva la que sustituye. Cada decisión registra el id y la versión exactos de la política que la tomó (en la solicitud, en el registro de auditoría y en el bloque policy de la carga útil del webhook), de modo que siempre puede ver qué versión decidió una verificación.

Haga clic en Versiones y prueba A/B en la cabecera del editor para:

  • Ver todas las versiones de la política (borrador, activa y archivadas) y abrir cualquiera de ellas en modo de solo lectura.
  • Restaurar como nuevo borrador: copia una versión anterior en un nuevo borrador con el mismo nombre. Publíquelo cuando quiera que esté en vivo. Nunca se modifica nada que ya estuviera publicado.
  • Ejecutar una prueba A/B: compare la versión activa (variante A) con un retador (variante B, un borrador o una versión anterior de la misma política). Elija el porcentaje de verificaciones nuevas que van a B (0–100 %); el resto sigue en A. La división es automática y estable: una verificación siempre cae en la misma variante, incluso si se vuelve a ejecutar.

Mientras la prueba está en curso, el borrador retador está congelado (editarlo invalidaría la comparación). La tabla de Resultados muestra, por variante, cuántas verificaciones se asignaron, el porcentaje aprobado, rechazado y escalado, y cuántas llegaron a una decisión. La comparación de tasas de aprobación solo indica que la diferencia es «significativa» cuando cada variante tiene al menos 30 verificaciones decididas. Para adoptar B, publique el retador: la prueba termina automáticamente. Para abandonarla, haga clic en Detener prueba; cada nueva verificación vuelve a la versión activa.

Solo puede ejecutarse una prueba por política a la vez; la política predeterminada integrada no puede probarse (clónela con un nombre nuevo primero), y la política se elige de la forma habitual: fijada en el formulario o, si no, la predeterminada de la organización. La prueba divide las verificaciones que decide esa política.