Configuración del Tenant

El comportamiento de la verificación se configura por tenant por parte de Inyo. Esta página es la referencia de lo que puede solicitar — durante el onboarding, o como un cambio posterior. No existe una API de configuración de autoservicio; envíe a su contacto de Inyo los ajustes que desea.

Las actualizaciones de configuración se fusionan con lo que ya está almacenado, por lo que solicitar el cambio de un ajuste deja el resto intacto. Devolver un ajuste a su valor predeterminado de la plataforma es una solicitud explícita, no una omisión.

Cada ajuste se nombra con la clave exacta que configuramos en su tenant. Citar la clave en una solicitud elimina cualquier ambigüedad sobre a qué comportamiento se refiere — varias tienen nombres parecidos, y en particular review_threshold y review_verification_declines hacen cosas muy distintas.

La mayoría de las claves viven dentro del objeto config de su tenant, pero webhook_url y branding están fuera de él, como hermanos de config — marcados abajo, y visibles en el payload de ejemplo.

Documentos y Jurisdicciones

Por ejemplo:

{
  "passport": ["SA", "USA"],
  "drivers_license": ["NA"]
}

Ese ejemplo acepta pasaportes de cualquier país de Sudamérica más EE. UU., y licencias de conducir de Norteamérica. Omitir un tipo de documento acepta todas las jurisdicciones para él.

Restrinja esto deliberadamente. Limitar los tipos de documento simplifica su manejo de datos posterior, pero cada restricción es un cliente que no puede completar el onboarding con la identificación que tiene.

Umbrales de Decisión

Elevar el umbral de coincidencia facial reduce los falsos positivos y aumenta los falsos rechazos — clientes reales rechazados. Ambos umbrales se citan en el detail de la comprobación correspondiente en cada resultado, de modo que su integración puede leer el valor efectivo en lugar de codificarlo de forma fija.

Enrutamiento de Revisión

Ambos se explican en detalle — incluyendo qué comprobaciones cuentan para la confianza, y por qué un umbral igual o inferior a su umbral de coincidencia facial nunca puede activarse — en Revisión Manual. Un umbral en ese rango inerte se rechaza en el momento de la configuración en lugar de aceptarse silenciosamente.

Habilitar rechazos retenidos genera trabajo de analistas sin límite en la cola. Habilítelo cuando un falso rechazo sea más costoso que una decisión demorada.

Comportamiento de Captura

Opciones de Enriquecimiento

Cada una de estas añade señal con un costo por verificación. Dos están desactivadas por defecto por esa razón, y una conlleva una obligación de cumplimiento.

Las descripciones de apariencia son datos personales sensibles. Conllevan exposición bajo el RGPD y leyes de privacidad biométrica (por ejemplo BIPA), y la selfie es procesada por un servicio de visión externo. Confirme que tiene una base legal, un acuerdo de procesamiento de datos vigente y una justificación de retención documentada antes de pedirnos habilitar esto.

Entrega y Presentación

branding es un objeto propio:

Los colores deben ser hexadecimales completos de 6 dígitos — la forma corta de 3 dígitos (#0F7) y el alfa de 8 dígitos (#0F766E80) son rechazados.

El pie de página "Powered by Inyo 360" siempre se muestra y de manera intencional no es configurable.

Los textos del widget — etiquetas, botones, pantallas de resultado, mensajes de reintento — se sirven desde el almacén de textos de Inyo en lugar de estar integrados en el frontend, de modo que los cambios de redacción por tenant y los idiomas adicionales no requieren un despliegue de su parte. Inglés, portugués y español vienen completos; cualquier otro código xx o xx-XX es aceptado, y las cadenas sin traducción recurren al inglés de forma individual.

Una Configuración Inicial

Si está haciendo el onboarding ahora y no está seguro de qué pedir, esta es una línea base sensata para onboarding de consumidores:

Luego revise los umbrales y el enrutamiento de revisión con datos reales, en lugar de en el momento de la integración.

Enviarnos una Configuración

Citar las claves directamente es la forma menos ambigua de hacer una solicitud. Esta es la forma que aplicamos a su tenant, y muestra el anidamiento: webhook_url y branding son hermanos de config, no miembros de él.

{
  "webhook_url": "https://acme.example.com/kyc-result",
  "branding": {
    "company_name": "Acme Bank",
    "logo_url": "https://acme.example.com/logo.png",
    "color_primary": "#0F766E",
    "color_background": "#FFFFFF",
    "color_text": "#111827"
  },
  "config": {
    "default_language": "pt-BR",
    "allowed_document_types": ["passport", "drivers_license"],
    "accepted_jurisdictions": {
      "passport": ["SA", "USA"],
      "drivers_license": ["NA"]
    },
    "allow_file_upload": false,
    "max_capture_attempts": 3,
    "review_verification_declines": true
  }
}

Incluya solo las claves que desea configurar — cualquier cosa omitida conserva su valor actual, ya que las actualizaciones se fusionan en lugar de reemplazar.

Próximos Pasos

• Revisión Manual — umbral de revisión y rechazos retenidos en profundidad
• Comprobaciones y Decisiones — qué comprobaciones afecta cada ajuste
• Entrega del Widget — cómo la marca y el idioma se presentan al cliente