Firmas desde tu propio software.

1. Paso 1

   Crea la solicitud

   Un POST /v1/signing-requests con el PDF, los firmantes y la colocación de los campos: anchors encuentra marcadores [[ls:signature:client]] en el PDF, explicit toma coordenadas, auto_append añade una página de firma. La respuesta trae el documentId y una signingUrl por firmante.

   En la documentación

   curl https://api.wesign.now/v1/templates/$TEMPLATE_ID/instantiate \
     -H "Authorization: Bearer $WSK_KEY" \
     -H "Idempotency-Key: case-4711/mandate" \
     -H "Content-Type: application/json" \
     -d '{
       "recipients": [{ "slot": 1, "email": "anna@example.ch", "name": "Anna Muster" }],
       "field_values": { "company.legal_name": "Muster AG", "company.tax_id": "CHE-123.456.789" },
       "metadata": { "case_id": "4711" }
     }'

   El mismo envío desde una plantilla bloqueada: POST /v1/templates/{id}/instantiate fusiona tus field_values en los {{placeholders}} e invita a los destinatarios.

2. Paso 2

   Tu firmante firma

   Enviamos la invitación en el idioma del firmante desde tu subdominio con tu marca — o entregas tú el enlace con send_emails: false. Añade un número de móvil y require_sms_verification, y el firmante introduce primero un código de un solo uso: una firma electrónica avanzada (AES) en lugar del nivel de enlace por correo (SES).

   En la documentación

   "signers": [{
     "email": "anna@example.ch",
     "role": "client",
     "name": "Anna Muster",
     "locale": "de",
     "phone_e164": "+41791112233",
     "require_sms_verification": true
   }]
   
   # The invitation goes out in German from your branded subdomain.
   # Anna asks for the code on the signing page; the signature is AES once verified.
   # Deliver the link yourself instead: send_emails=false

3. Paso 3

   Recibes el evento

   Registra un webhook una vez para el espacio de trabajo, o pasa callback_url por solicitud. Cada entrega va firmada con HMAC-SHA256, se reintenta con backoff exponencial y queda en un registro de entregas desde el que puedes reenviar. document.completed llega una vez por documento con signed_pdf_url, audit_trail_url y el sha256 del archivo.

   En la documentación

   POST https://your-app.example/wesign/callback
   X-WeSign-Event: document.completed
   X-WeSign-Signature: t=1757404800,v1=9c3b…a2f1
   
   {
     "event": "document.completed",
     "document_id": "8a1e4f9a-…",
     "metadata": { "case_id": "4711" },
     "signed_pdf_url": "https://api.wesign.now/v1/documents/8a1e4f9a-…/signed",
     "audit_trail_url": "https://api.wesign.now/v1/documents/8a1e4f9a-…/audit-trail",
     "sha256": "4f9a…d21c", …
   }

4. Paso 4

   Descarga los archivos

   GET /v1/documents/{id}/signed devuelve el PDF sellado PAdES, todas las firmas bajo un solo sello; /audit-trail genera el registro de eventos — SHA-256, sello de tiempo, IP enmascaradas — como PDF, siempre en inglés. Ambos necesitan tu clave. Compara el hash y guarda ambos archivos en tu sistema.

   En la documentación

   curl -LOJ -H "Authorization: Bearer $WSK_KEY" \
     https://api.wesign.now/v1/documents/$DOC_ID/signed
   
   curl -OJ -H "Authorization: Bearer $WSK_KEY" \
     https://api.wesign.now/v1/documents/$DOC_ID/audit-trail
   
   # Compare the file's SHA-256 with the event's sha256, then store both files on your side.

Cada respuesta lleva un X-Request-Id, y Ajustes → API guarda 30 días un registro API de cada llamada — estado, código de error, documento afectado; los cuerpos nunca se almacenan. Una Idempotency-Key hace seguro reintentar un envío o un instantiate. Cada clave puede hacer 60 solicitudes por minuto.