ℹ️ Validaciones de Identidad

Combinaciones y Estrategias por Firmante

Al generar un proceso de firma, es fundamental comprender las diferentes combinaciones posibles de validaciones de identidad, así como las estrategias que permiten aplicarlas de forma global o individual por firmante.

Para estructurar dichas validaciones existen reglas que debes tener en cuenta para asegurar que el proceso funcione correctamente.

1. Tipos de validaciones disponibles

Las validaciones de identidad que puedes combinar en un proceso incluyen:

Validación	Tipo	Requerido	Descripción
camera	Boolean	Opcional	Solicita una foto del rostro del firmante.
otpCode	Boolean	Opcional	Solicita código de verificación.
both	Boolean	Opcional	Habilita notificación por correo y WhatsApp.
options.camera	Boolean	Condicional	Si desea cotejar la foto del rostro con el ID del firmante se debe enviar en este campo 'identification' o si se desea solo la foto del participante, enviar 'photo'.
options.otpCode	Boolean	Condicional	Este campo acepta los valores 'phone' e 'email'. para indicar por qué medio recibirá el código de firmante en caso de enviar otpCode en true en la base de la data.
options.whatsapp	Boolean	Condicional	Envíe este campo en true sólo si desea que el flujo de firma de este firmante se desarrolle a través de WhatsApp, por defecto es false.
options.both	Boolean	Condicional	Envíe este campo en true sólo si desea que el flujo de firma de este firmante se desarrolle a través de WhatsApp y correo electrónico, por defecto es false.
options.video	Boolean	Condicional	Envíe este campo en true sólo si desea que la validación de identidad se realice por medio de video, por defecto es false, solo disponible para WhatsApp.
options.identificationCardback	Boolean	Condicional	Envíe este campo en true sólo si desea que la validación de identidad adicionalmente solicite la parte posterior del documento solo disponible para WhatsApp.
options.flow	Boolean	Condicional	Envíe este campo en true sólo si desea que la validación de identidad se realice por medio de formularios dentro de WhatsApp Flow solo disponible para WhatsApp.

info

Aquí puedes ver la lista de países y documentos de identidad que aceptamos

2. Validaciones globales e individuales

Puedes aplicar las validaciones de dos maneras:

• Globales: en la raíz de la petición. Se aplican automáticamente a todos los firmantes.
• Individuales: en el objeto signProfile[x], para validar a cada firmante de forma personalizada.

info

Las validaciones individuales tienen prioridad sobre las globales cuando se declaran ambas.

3. Reglas clave

1. options.camera = 'identification' activa comparación biométrica, pero solo funcionará si el firmante tiene identification, country e identificationType definidos.
2. options.video = true no tendrá efecto a menos que también se active options.whatsapp = true.
3. options.both = true indica que el firmante debe recibir notificaciones por correo y WhatsApp al mismo tiempo, para que sea efectivo: options.whatsapp = true.
4. Si declaras options pero no activas camera ni otpCode por fuera, El proceso no será válido.
5. options.flow = true para que esto sea efectivo, se debe solicitar como mínimo camera:true y options.camera: 'identification o options.camera: 'photo

4. Ejemplos:

Validaciones globales:

{
  ...,
  "camera": true,
  "otpCode": true,
  "options": {
    "camera": "identification",
    "otpCode": "email",
  }
  "signProfile": [
    {
      "name": "Firmante 1",
      "email": "example@auco.ai",
      "phone": "+573000000000",
      "identification": "123456789",
      "identificationType": "CC",
      "country": "CO"
    },
    {
      "name": "Firmante 2",
      "email": "example2@auco.ai",
      "phone": "+573000000000",
      "identification": "123456789",
      "identificationType": "CC",
      "country": "CO"
    }
  ],
  ...
}

Validaciones individuales:

{
  ...,
  "signProfile": [
    {
      "name": "Firmante 1",
      "email": "example@auco.ai",
      "phone": "+573000000000",
      "camera": true,
      "otpCode": true,
      "identification": "123456789",
      "identificationType": "CC",
      "country": "CO"
      "options": {
        "camera": "identification",
        "video": true,
        "whatsapp": true,
        "otpCode": "email"
      }
    }
  ],
  ...
}