Skip to content

Notas — IdentiaSign

Nota 12032026

Fecha de Publicación: 12 de marzo del 2026

Vigencia: TBD

Actualmente, cuando se crea un proceso de firma con multiples firmantes, el sistema genera un único link compartido para todos.

Próximamente, el sistema comenzará a generar un link exclusivo para cada firmante. Cada link lleva incorporada internamente la identidad del firmante, por lo que cuando una persona accede a su link, el sistema ya sabe quién es sin necesidad de pedirle su identidad. Esto simplifica la experiencia del firmante y agrega una capa adicional de seguridad, ya que cada link solo es valido para el firmante al que fue asignado en el canal de notificación elegido.

APIs afectadas

1. PUT /api/signature_processes

Actualmente — se retornaba un unico link como texto:

{
  "id": "e3a8b6cde5f74aa692e49ee6b3d56c0f:6d0050228e339b28",
  "msg": "https://apisignqa.identia.pe/ui/signature_processes/..."
}

Próximamente — se retorna una lista con un link personalizado por cada firmante:

Un firmante:

{
  "id": "e3a8b6cde5f74aa692e49ee6b3d56c0f:d6892e68e6edbd22",
  "msg": [
    {
      "link": "https://apisignqa.identia.pe/ui/signature_processes/...",
      "nat_dni": "PER:74407841"
    }
  ]
}

Multiples firmantes:

{
  "id": "e3a8b6cde5f74aa692e49ee6b3d56c0f:d6892e68e6edbd22",
  "msg": [
    {
      "link": "https://apisignqa.identia.pe/ui/signature_processes/...",
      "nat_dni": "PER:11111111"
    },
    {
      "link": "https://apisignqa.identia.pe/ui/signature_processes/...",
      "nat_dni": "PER:11111112"
    }
  ]
}

Donde: - nat_dni: identificador del firmante en formato nacionalidad:documento (ej: PER:74407841). - link: link de firma exclusivo para ese firmante. Cada firmante debe recibir unicamente su propio link.

Caso especial para la futura actualización — si el proceso se crea con aprobacion pendiente:

{
  "id": "e3a8b6cde5f74aa692e49ee6b3d56c0f:6d0050228e339b28",
  "msg": "approvalPending"
}

En este caso, msg es el texto "approvalPending" indicando que el proceso aun requiere aprobacion antes de generar los links de firma.

2. POST /api/notify

Esta API se verá afectada de la misma manera.

Actualmente — se retornaba un unico link como texto:

"https://apisignqa.identia.pe/ui/signature_processes/..."

Próximanente — se retorna una lista con un link personalizado por cada firmante:

[
  {
    "link": "https://apisignqa.identia.pe/ui/signature_processes/...",
    "nat_dni": "PER:11111112"
  }
]

Cada elemento de la lista corresponde a un firmante, con su nat_dni y su link exclusivo.

Cambio en el parametro readChallenges

Al crear un folio, el campo readChallenges en el body del request controla si el firmante debe identificarse manualmente al ingresar al link.

Valor de readChallenges Comportamiento
No se envia / ["signerId"] El firmante debera ingresar su DNI al abrir el link (comportamiento que ya existia).
[] (lista vacia) Nuevo: El firmante no deberá ingresar su DNI. El sistema lo identifica automaticamente.

Resumen de cambios

Que cambia Antes Ahora
msg en respuesta de PUT /api/signature_processes Un unico link (texto) Lista de objetos con link y nat_dni por firmante
msg en respuesta de POST /api/notify Un unico link (texto) Lista de objetos con link y nat_dni por firmante
Proceso con aprobacion pendiente Retornaba un link Retorna "approvalPending"
readChallenges: [] No soportado El firmante no necesita ingresar su DNI
Links de firma Un link compartido para todos Un link exclusivo por firmante

Recomentamos poder programar la actualización de sus integraciones con antelación.