# Links de firmantes

Fuente: /document-management/signer-links/

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.

> **Nota**
>
> No existe un endpoint que regrese el link directamente como un campo — se **construye** a partir del `id` del firmante (`signature.id`), que ya obtienes al [crear un documento](/document-management/create-document) o al [consultarlo](/document-management/show-document). Es la misma fórmula que usa nuestra app web al mostrar el ícono "Copiar enlace de firma" en el detalle de un documento.

***

## 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).

1. **Obtén el `id` de cada firmante**

   Al [crear el documento](/document-management/create-document) o al [consultarlo](/document-management/show-document), el `id` de cada firmante viene en `relationships.signatories.data[].id`:

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

2. **Arma el enlace con ese `id`**

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

3. **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

**1. Consultar el documento**

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

**2. Extraer signature\_id**

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

**3. Construir el link**

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

> **Siguiente paso**
>
> Para saber si un firmante ya usó su enlace, consulta de nuevo [Mostrar un documento](/document-management/show-document) y revisa el `sign_status` de cada firmante, o suscríbete a [Webhooks](/webhooks/webhooks-introduction) para recibir la notificación en tiempo real.