Links de firmantes

Cuando creas un documento, Verificamex notifica automáticamente a cada firmante por correo (y opcionalmente WhatsApp) con su enlace de firma. Sin embargo, si tu integración necesita enviar tus propias notificaciones, mostrar el link dentro de tu propia plataforma, o simplemente reenviarlo manualmente, puedes construir ese mismo enlace tú mismo.

Fórmula del enlace

https://app.verificamex.com/signature/sign-document/{signature_id}

Donde {signature_id} es el id del recurso signatures (no el id del documento).

Obtén el id de cada firmante

Al crear el documento o al consultarlo, el id de cada firmante viene en relationships.signatories.data[].id:

{
  "relationships": {
    "signatories": {
      "data": [
        {
          "type": "signatures",
          "id": "ac110005-9df4-1d1b-819d-f60440c7003d",
          "attributes": {
            "name": "Leonardo Rosas",
            "email": "leonardo.rosas041024@gmail.com",
            "sign_status": "PENDING"
          }
        }
      ]
    }
  }
}

Arma el enlace con ese id

https://app.verificamex.com/signature/sign-document/ac110005-9df4-1d1b-819d-f60440c7003d

Compártelo con el firmante por el canal que prefieras (tu propio correo, WhatsApp, SMS, tu portal, etc.).

Qué debes saber antes de usarlo

Es un enlace público

No requiere token, API Key ni sesión iniciada. Cualquier persona que lo abra puede acceder directamente al proceso de firma de ese firmante — trátalo como información sensible, igual que harías con el correo de invitación.

Es independiente del flujo de identidad

El enlace no cambia aunque el firmante ya tenga un proceso de validación de identidad (signature_flow) en curso. La página de destino se encarga internamente de redirigir al paso correspondiente (elegir proveedor de identidad, continuar verificación, o ir directo a firmar con certificado propio).

Válido mientras el firmante esté pendiente

El enlace tiene sentido mientras sign_status del firmante sea PENDING. Una vez que firma (SIGNED) o rechaza (REJECTED), la página ya no ofrece la acción de firmar.

Un `id` por firmante

Cada firmante tiene su propio signature_id y por lo tanto su propio enlace — no existe un enlace único “del documento” que sirva para todos los firmantes.

Ejemplo completo

curl --location 'https://api.digitafirma.com/v1/documents/{uuid}' \
--header 'X-Api-Key: {X-API-KEY}'

// De la respuesta anterior, por cada firmante:
"relationships": {
  "signatories": {
    "data": [
      { "id": "ac110005-9df4-1d1b-819d-f60440c7003d", "attributes": { "email": "leonardo.rosas041024@gmail.com" } }
    ]
  }
}

https://app.verificamex.com/signature/sign-document/ac110005-9df4-1d1b-819d-f60440c7003d