Una vez que un documento fue creado y subido, cada firmante tiene un registro de firma (signature.id) que representa su pendiente de firma. Para completar o rechazar esa firma, tu integración llama a un único endpoint:
Método: POST https://api.digitafirma.com/v1/sign/{signatureId}
El campo allow_type_signatures que configuraste al crear el documento determina qué caminos están disponibles para ese firmante:
Certificado propio (e.firma / FIREL / TEPJF)
El firmante sube su propio certificado (.cer + .key, o .pfx) más su contraseña. Tu integración es responsable de recolectar esos archivos y reenviarlos tal cual al endpoint de firma.
Ver guía: Firmar con e.firma
Flujo guiado (VERIFICAMEX)
El firmante no trae certificado propio: valida su identidad dentro del flujo de Verificamex Firma (INE + RENAPO, o video + OTP) y el sistema le emite un certificado automáticamente. Requiere haber completado antes un flujo de firmado (signatureFlowId) y enviarlo junto con signatureStroke.
Cualquiera de los dos métodos anteriores se reemplaza por un rechazo si envías:
| Campo | Tipo | Descripción |
|---|---|---|
reject | boolean | Envía true para rechazar en lugar de firmar. |
commentary | string | Comentario opcional del motivo del rechazo (soporta texto enriquecido). |
No es necesario enviar certificado, contraseña ni signatureFlowId cuando reject es true.