> ## Documentation Index
> Fetch the complete documentation index at: https://developers.verifica.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks de FirmaID

> Recibe notificaciones en tiempo real de eventos de firma

## Descripción General

Los webhooks de FirmaID te permiten recibir notificaciones en tiempo real sobre eventos de solicitudes de firma. Configura tu URL de webhook para recibir solicitudes POST con actualizaciones de firma.

## Eventos de Webhook

### Firma Completada

Se activa cuando todos los firmantes han completado la firma de un documento.

```json theme={null}
{
  "event": "signature.completed",
  "signature_id": "uuid",
  "status": "completed",
  "timestamp": "2024-01-01T00:00:00Z",
  "data": {
    "document_url": "https://...",
    "signers": []
  }
}
```

### Firma Firmada

Se activa cuando un firmante individual completa su firma.

```json theme={null}
{
  "event": "signature.signed",
  "signature_id": "uuid",
  "signer_id": "uuid",
  "timestamp": "2024-01-01T00:00:00Z"
}
```

### Firma Rechazada

Se activa cuando un firmante rechaza la solicitud de firma.

```json theme={null}
{
  "event": "signature.rejected",
  "signature_id": "uuid",
  "signer_id": "uuid",
  "reason": "string",
  "timestamp": "2024-01-01T00:00:00Z"
}
```

## Configuración

Configura tu URL de webhook en el dashboard de Verifica o inclúyela al crear una solicitud de firma.

## Seguridad

Todas las solicitudes de webhook están firmadas. Verifica la firma en el header `X-Verifica-Signature` para asegurar que la solicitud es auténtica.