Verificación de identidad

Puedes pedirle al firmante una verificación de identidad antes de firmar: es una capa extra de seguridad que confirma quién es, además de la autoridad de firma que ya usas. No la sustituye — se combina con cualquiera de ellas —, y la activas cuando el trámite necesita ese nivel adicional de certeza.

Cómo activarla

Agrega requireIdentityVerification: true al sticker:

{
  authority: 'EMAIL_LINK',
  data: '[email protected]',
  email: '[email protected]',
  requireIdentityVerification: true,
  page: 0,
  rect: { lx: 330, ly: 300, tx: 530, ty: 400 },
}

Si en cambio defines el sticker dibujando el recuadro dentro del PDF, el equivalente es la palabra clave riv:

Firmamex [email protected] riv

Es un campo opcional y por defecto false — nada cambia si no lo mandas. Hoy solo está disponible en el sticker que se manda al crear un documento (POST /developers/json); los stickers premade de un expediente no lo incluyen.

El proceso

El firmante pasa por dos pasos antes de poder firmar:

• Identificación oficial. Sube una identificación vigente, legible y a color — una fotocopia, una imagen borrosa o un documento vencido no pasan.
• Prueba de vida. Una selfie tomada en el momento, para comprobar que quien la toma es una persona real —no una foto, no una pantalla, no otra identificación— y que corresponde a la persona de la identificación.

Firmame corre varias verificaciones independientes sobre esos dos elementos, y el firmante puede reintentar si alguna no pasa. El catálogo completo de verificaciones y de los mensajes que puede devolver cada una está en la referencia del webhook, más abajo.

Créditos

Cada verificación de identidad consume créditos adicionales de tu cuenta, aparte de los que usa el documento.

El webhook

El resultado no llega en la respuesta de la API — llega por webhook:

• identity_verification_completed — el firmante ya quedó verificado y puede firmar.
• identity_verification_failed — alguna verificación no pasó.

Ambos comparten la misma forma: meta es un arreglo con un intento por entrada, así que un firmante que falla y reintenta no genera varias notificaciones — genera una sola, con el arreglo más largo.

{
  "notification_type": "identity_verification_completed",
  "notification_id": "2701",
  "firmamex_id": "04337396-e929-43ca-9b8a-ec958a44079d",
  "document_title": "documento.pdf",
  "meta": [
    {
      "status": "FAILURE",
      "date": "2025-03-24T04:11:42.000Z",
      "signer": "[email protected]",
      "errors": [{ "category": "USABILITY", "message": "PHOTOCOPY" }]
    },
    {
      "status": "SUCCESS",
      "date": "2025-03-25T10:38:11.000Z",
      "signer": "[email protected]",
      "errors": []
    }
  ]
}

Como meta guarda todo el historial, en identity_verification_completed lee la entrada con status: "SUCCESS" en vez de asumir que solo hay una — puede venir precedida de varios intentos fallidos, como en el ejemplo. En identity_verification_failed, en cambio, todas las entradas son fallos, y el evento trae además first_notification_date, la fecha del primer intento de esa serie.

Cada error trae una category (qué verificación falló: identificación oficial o prueba de vida) y un message con el detalle — el catálogo completo de ambos está documentado en la referencia.

Referencia