Crear una clave de API y tu primer sobre

Una clave del equipo, un POST con el PDF y los datos de tu cliente, y un enlace de firma por firmante.


  1. 1

    Un propietario o gerente abre Developers, nombra una clave (por ejemplo "Website") y toca Create key. Cópiala ya — empieza con es_live_ y se muestra una sola vez.

  2. 2

    Envía POST https://api.socialdna.app/api/esign/v1/envelopes con Authorization: Bearer es_live_… (o X-Api-Key) y un cuerpo JSON: title, document (base64 o una url https), signers (nombre, correo, teléfono, channel: email, whatsapp, sms, call o link, y valores prefill) y, si quieres, fields, message, order, expires_days y ext_ref.

  3. 3

    La respuesta trae el sobre y un signing_url para cada firmante. Usa deliver: false para obtener los enlaces sin enviar nada, o send: false para guardar un borrador.

  4. 4

    Lee sobres con GET /v1/envelopes y GET /v1/envelopes/{id}, descarga el PDF con GET /v1/envelopes/{id}/document, envía un borrador con POST /v1/envelopes/{id}/send, anula con POST /v1/envelopes/{id}/void y revisa el uso con GET /v1/account.

Consejo: Guarda las claves en tu servidor, nunca en una página web. Revoca una clave en Developers y las apps que la usan dejan de funcionar de inmediato.

¿Aún necesitas ayuda?

Nuestro equipo responde por ticket y correo.