API REST de firma electrónica simple
API de firma electrónica para Chile, sin construir la verificación de identidad.
Tu app envía el PDF con un llamado REST y recibe el contrato firmado de vuelta.
curl -X POST https://api.validafirma.cl/api/fes/documentos \
-H "X-API-Key: $VALIDAFIRMA_API_KEY" \
-F "documento=@contrato.pdf" \
-F 'firmantes=[{"rut":"49999901-1","canal":"whatsapp","telefono":"+56912345678"}]' \
-F "webhook_url=https://tu-sistema.cl/webhooks/validafirma"import fs from 'node:fs';
const form = new FormData();
form.append('documento', new Blob([fs.readFileSync('contrato.pdf')], { type: 'application/pdf' }), 'contrato.pdf');
form.append('firmantes', JSON.stringify([{ rut: '49999901-1', canal: 'whatsapp', telefono: '+56912345678' }]));
form.append('webhook_url', 'https://tu-sistema.cl/webhooks/validafirma');
const r = await fetch('https://api.validafirma.cl/api/fes/documentos', {
method: 'POST',
headers: { 'X-API-Key': process.env.VALIDAFIRMA_API_KEY },
body: form,
});
console.log(r.status); // 201import json, os
import requests
with open("contrato.pdf", "rb") as pdf:
r = requests.post(
"https://api.validafirma.cl/api/fes/documentos",
headers={"X-API-Key": os.environ["VALIDAFIRMA_API_KEY"]},
files={"documento": ("contrato.pdf", pdf, "application/pdf")},
data={
"firmantes": json.dumps([{"rut": "49999901-1", "canal": "whatsapp", "telefono": "+56912345678"}]),
"webhook_url": "https://tu-sistema.cl/webhooks/validafirma",
},
)
print(r.status_code) # 201Con una llave de prueba, nada se envía ni se cobra. El RUT 49999901-1 firma solo.
Tu equipo pone el documento. ValidaFirma aporta la identidad, la firma y la prueba.
Las pantallas de firma
En el navegador del celular, sin instalar nada y sin crear cuenta.
La verificación de identidad
Cédula vigente y rostro, con PINRUT. Tu app nunca recibe un dato biométrico.
Los mensajes
WhatsApp, SMS de respaldo y correo. No contratas ni configuras ninguno.
El sello y la custodia
El PDF sale sellado, con sello de tiempo, y la evidencia se guarda 6 años.
Envías, firman y te llega el aviso.
Tu app envía el documento
El PDF, el RUT de cada firmante y la URL de tu webhook, la dirección donde tu app recibe el aviso.
POST /api/fes/documentos
201 · "estado": "pendiente"
Cada persona firma en su celular
Le llega un WhatsApp, verifica su identidad y firma.
- La primera vez
- menos de 2 minutos
- Las siguientes
- menos de 15 segundos
Te llega el aviso
Firmado con el secreto de tu cuenta. Tu app descarga el PDF sellado con su llave.
evento documento.completado
X-Webhook-Signature: sha256=…
Los 9 llamados de la API REST
- POST/
api/ Crear un documento para firmafes/ documentos - GET/
api/ Listar documentosfes/ documentos - GET/
api/ Consultar el estadofes/ documentos/ {documentoId} - POST/
api/ Reenviar la invitación a quien faltafes/ documentos/ {documentoId}/ reenviar-notificaciones - PATCH/
api/ Cancelar un documento en cursofes/ documentos/ {documentoId}/ cancelar - GET/
api/ Descargar el PDF firmado y selladofes/ documentos/ {documentoId}/ descargar - GET/
api/ Con qué llave operas y en qué modoauth/ whoami - GET/
api/ Carpetas de la cuenta corporativafes/ carpetas - GET/
api/ Mensajes que no se enviaron (modo de prueba)fes/ mensajes-simulados
Los RUT de prueba, los eventos y cada campo están en la documentación. Con Claude Code, Codex o Cursor, tu agente la integra: integrar con IA.
Precio
$690+ IVA por firma
5 firmas gratis, 30 díasSin costo mensual. Incluye la verificación, el WhatsApp y la custodia.
Identidad verificada
Cada firma, a nombre de una persona verificada.
- Que su cédula está vigente y es del RUT que enviaste
- Que su rostro es el de la cédula
- Que está ahí, ahora: una prueba de vida cada vez que firma
Tu app recibe el nombre verificado y un comprobante firmado, nunca un dato biométrico.
Cómo funciona la identidad verificadaValidez legal
Vale según la Ley 19.799.
La ley la llama firma electrónica simple, y vale como firma manuscrita, salvo en los actos que la misma ley excluye y en los instrumentos públicos, que piden firma electrónica avanzada. Cualquiera valida el PDF firmado en línea, y Adobe Acrobat verifica su sello sin conexión.
Lo que pregunta quien integra.
Si tu pregunta no está aquí, escríbenos.
¿Es una API REST?
Sí. Se habla por HTTPS con api.validafirma.cl: un POST en multipart/form-data crea el documento, y consultar el estado, descargar el PDF, reenviar la invitación o cancelar son llamados aparte. Las respuestas vienen en JSON, y la referencia OpenAPI está publicada.
¿Con qué lenguaje la integro?
Con cualquiera que haga una petición HTTP y calcule un HMAC-SHA256 para comprobar el webhook. La documentación trae los llamados en curl y la verificación del webhook en Node.js y en Python.
¿Puedo integrarla con Claude Code, Codex o Cursor?
Sí. Instalas el CLI de ValidaFirma, que le entrega a tu agente la guía vigente y el skill que le dice cómo usarla, y le pides que integre la firma en modo de prueba. Pasar a producción lo apruebas tú en el navegador. Los comandos están en Integrar con IA.
¿Qué es una API FES?
FES es la sigla de firma electrónica simple, y una API FES es la que envía documentos a firma, con esa firma, desde tu app. Los llamados de firma de ValidaFirma viven bajo la ruta /api/fes/. Si estás diseñando la integración, la guía de integración recorre las decisiones, el flujo y los errores típicos.
¿Es firma electrónica avanzada?
No. ValidaFirma es firma electrónica simple. La avanzada exige un certificado emitido por un prestador acreditado y es otra categoría legal, con otros requisitos.
La firma electrónica simple vale como firma manuscrita según la Ley 19.799 (art. 3), salvo en los actos que ese artículo excluye y en los instrumentos públicos, que piden firma electrónica avanzada (art. 4). Si tu documento la exige, ValidaFirma no sirve para él.
¿Es lo mismo que una API de firma digital?
Sí. Firma digital y firma electrónica son 2 maneras de llamarla, y la Ley 19.799 la llama firma electrónica simple. Lo que importa es que vale según esa ley.
¿Puedo probarla sin pagar?
Sí, con el modo de prueba: el mismo host, la misma API y el mismo contrato, con una llave de prueba. Corren las validaciones, los estados, los webhooks firmados y el PDF sellado. Los mensajes van a una bandeja simulada, la verificación de identidad se simula y nada se cobra. El tope es de 200 documentos de prueba al día. Cómo funciona el modo de prueba.
Cuando estés listo para probar con documentos reales, te regalamos 5 firmas, para usar en 30 días desde que las canjeas.
¿Cómo sé que el aviso viene de ValidaFirma?
Cada aviso trae la cabecera X-Webhook-Signature, un HMAC-SHA256 calculado con el secreto de webhooks de tu cuenta. Lo recalculas con el cuerpo crudo y lo comparas. Si tu servidor no responde, el aviso se reintenta. Los eventos y cómo comprobar la firma.
¿El PDF firmado llega en el webhook?
No. Tu sistema lo descarga con su llave, con GET /api/fes/documentos/{id}/descargar, cuando llega el aviso. Cada firmante recibe por su canal un enlace propio para descargar su copia.
¿Quién puede firmar?
Una persona natural, con su RUT. Un RUT de persona jurídica se rechaza: si alguien firma por una empresa, va el RUT de esa persona. Un documento lleva de 1 a 100 firmantes, y todos reciben la invitación a la vez.
¿Cuánto cuesta?
En la cuenta personal pagas $690 más IVA por firma, sin costo mensual, y cada firma incluye la verificación de identidad, el WhatsApp, el sello de tiempo y la custodia. El Plan empresa tiene planes mensuales con firmas incluidas. El detalle está en precios.
Intégralo completamente gratis con una API key de sandbox
Crea tu cuenta, genera una llave de prueba y envía tu primer documento a firma. Nada se envía ni se cobra, y pasar a producción es cambiar la llave.
Cuando estés listo para probar con documentos reales, te regalamos 5 firmas, para usar en 30 días desde que las canjeas. Sin costo mensual. Solo pagas lo que usas: $690 más IVA por firma.