Wapi Firma API 📝

Bienvenido a la documentación oficial de la API de Wapi Firma. Esta API te permite integrar la firma electrónica de documentos en tus sistemas de forma segura, rápida y legalmente válida, utilizando WhatsApp como canal de comunicación.

Base URL: https://api.wapifirma.com/

Privacidad de los archivos

Los documentos, reportes y fotos de firmantes son privados: la API nunca devuelve links públicos a los archivos. Los archivos se descargan como bytes binarios desde endpoints autenticados con tu x-api-key, que además validan que el documento pertenezca a tu cuenta o equipo (devuelven 404 si no).

Autenticación

Todos los endpoints usan el header:

x-api-key: your-api-key-here

Postman Collection

📦 Descargar collection — incluye un ejemplo con variables para cada endpoint. Importala en Postman (o Insomnia / Bruno) y configurá las variables de la collection:

  • api_key — tu API key
  • id_seguimiento — el ID de seguimiento de un documento tuyo
  • id_custom — el identificador de un firmante (lo devuelve Solicitar Documento)
  • photo_type — selfie o dni

Los endpoints de descarga devuelven el archivo en binario: en Postman usá Send and Download (Ctrl/Cmd + Alt + Enter) para guardarlo.

Endpoints

Endpoint Método Descripción
/api/v2/documentSet POST Solicitar la firma de un documento
/api/sendCargaMasiva POST Envío masivo de documentos
/api/v2/list GET Listar documentos enviados
/api/v2/documents/{id_seguimiento} GET Descargar el PDF firmado
/api/v2/reporte/{id_seguimiento} GET Descargar el reporte legal
/api/v2/signers/{id_custom}/photo/{type} GET Descargar la foto del DNI o selfie del firmante
/api/v2/signatureStatus/{id_seguimiento} GET Estado de firma de un documento o firmante
/api/validateImage POST Validar selfie y DNI con reconocimiento facial
/api/deleteDocument/{id_seguimiento} DELETE Eliminar un documento no firmado
/api/account/changeBusinessName PUT Cambiar el nombre comercial

Nota para integraciones existentes: la versión anterior de la API (v1, con links públicos a S3) sigue funcionando y no tiene fecha de baja, pero ya no se recomienda para integraciones nuevas.

Table of contents