Saltar al contenido

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.

POST /api/fes/documentos
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); // 201
import 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)  # 201

Con una llave de prueba, nada se envía ni se cobra. El RUT 49999901-1 firma solo.

Recíbelo en tu WhatsApp, como tu usuario.

Ingresa tu número y fírmalo tú, como lo firmaría tu usuario.

+56

Te llega un WhatsApp con un documento que dice PRUEBA. Sin registrarte y sin instalar nada.

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.

  1. 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"

  2. 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
  3. 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/fes/documentosCrear un documento para firma
  • GET/api/fes/documentosListar documentos
  • GET/api/fes/documentos/{documentoId}Consultar el estado
  • POST/api/fes/documentos/{documentoId}/reenviar-notificacionesReenviar la invitación a quien falta
  • PATCH/api/fes/documentos/{documentoId}/cancelarCancelar un documento en curso
  • GET/api/fes/documentos/{documentoId}/descargarDescargar el PDF firmado y sellado
  • GET/api/auth/whoamiCon qué llave operas y en qué modo
  • GET/api/fes/carpetasCarpetas de la cuenta corporativa
  • GET/api/fes/mensajes-simuladosMensajes que no se enviaron (modo de prueba)

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 verificada

Validez 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.