API e webhook di Clinch

Tre ricette

• Invia un contratto dalla tua app

  POST /api/v1/documents con un modello o il tuo testo e i firmatari: il contratto viene creato e inviato in firma con una sola chiamata, con acconto facoltativo.

• Fattura quando il lavoro è approvato

  Ascolta contract.signed e chiama POST /api/v1/invoices per fatturare la prima milestone con un link di pagamento.

• Sincronizza clienti e documenti con il tuo CRM

  GET /api/v1/clients e /api/v1/documents restituiscono stato, firmatari e link di firma per tenere aggiornati i tuoi dati.

Configuralo

1. Crea una chiave in Clinch in Impostazioni → Chiavi API e inviala come Authorization: Bearer <chiave>.
2. Crea un contratto con POST /api/v1/documents (title, template o text, signers, deposit_cents facoltativo).
3. Iscriviti agli eventi con POST /api/v1/webhooks o in Impostazioni → Integrazioni (Pro).
4. Verifica l'header X-Clinch-Signature di ogni consegna con il tuo segreto di firma.

Esempio

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"}]}'

Domande