API y webhooks de Clinch

Tres recetas

• Envía un contrato desde tu propia app

  POST /api/v1/documents con una plantilla o tu texto y los firmantes: el contrato se crea y se envía a firmar en una sola llamada, con anticipo opcional.

• Factura cuando se aprueba el trabajo

  Escucha contract.signed y llama a POST /api/v1/invoices para facturar el primer hito con un enlace de pago.

• Sincroniza clientes y documentos con tu CRM

  GET /api/v1/clients y /api/v1/documents devuelven estado, firmantes y enlaces de firma para mantener tus registros al día.

Configúralo

1. Crea una clave en Clinch en Configuración → Claves API y envíala como Authorization: Bearer <clave>.
2. Crea un contrato con POST /api/v1/documents (title, template o text, signers, deposit_cents opcional).
3. Suscríbete a eventos con POST /api/v1/webhooks o en Configuración → Integraciones (Pro).
4. Verifica la cabecera X-Clinch-Signature de cada entrega con tu secreto de firma.

Ejemplo

curl https://clinch.lumnika.com/api/v1/documents \
  -H "Authorization: Bearer clk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"title":"Logo design","template":"logo-design-contract",
       "signers":[{"name":"Jane Doe","email":"jane@acme.com"}]}'

Preguntas