Resultado de firma de documentos
Este callback pertenece al producto de firma de documentos (la API de
<empresa>.datil.id
), no a la API de la plataforma — está aquí porque toda integración que envía a firmar termina recibiéndolo. Al completarse una solicitud, los PDF firmados llegan por POST a la
callback_url
que enviaste al crearla.
El contrato#
-
callback_urldebe ser HTTPS. -
La autenticación es un Bearer opcional configurado por organización — no la firma HMAC de los webhooks de comprobantes. Verifica además el
hashSHA-256 de cada PDF recibido. -
Tu
2xxconfirma la entrega; si no, se reintenta con retroceso exponencial, hasta 5 intentos. -
client_idrepite la clave que le diste al documento al crear la solicitud (documents[].id), para reconocer cada PDF firmado sin depender del nombre del archivo. -
El estado también puede consultarse:
GET /api/v1/signature-requests/:reference_id. Los endpoints están en Solicitudes de firma.
POST <callback_url>
Content-Type: application/json
Authorization: Bearer <token> # opcional, por organización
{
"reference_id": "CRED-2026-0001",
"signed_at": "2026-07-03T15:22:41Z",
"signers": [
{
"national_id": "0912345678",
"name": "Juan Pérez",
"email": "juan@ejemplo.com",
"role": "deudor",
"order": 1,
"signed_at": "2026-07-03T15:22:41Z"
}
],
"documents": [
{
"id": "…",
"client_id": "contrato", # tu propia clave, si la enviaste
"name": "Contrato.pdf",
"hash": "<sha-256 del PDF firmado>",
"content_base64": "<PDF firmado>"
}
]
}