Comment intégrer la signature électronique de bail dans votre logiciel

20 février 2026 1 min de lecture

Guide technique pas-à-pas pour intégrer la signature eIDAS de bail dans votre application SaaS. REST API, JWT, webhooks, exemples curl et SDK.

Démarrer l’intégration

Plan gratuit · 19€/signature · Sans engagement

<1h

Temps d’intégration pour un développeur expérimenté

7

Endpoints de signature à maîtriser

JWT

Authentification, token Bearer scopé organisation

SDK

Client OpenAPI générable depuis la spec swagger.json

⚡ 5 endpoints pour intégrer la signature en 1h

JWT auth : POST /auth/login → Bearer token
Créer le bail : POST /leases
Initier : POST /leases/{id}/signature/initiate
Valider OTP : POST /leases/{id}/signature/validate/{type}
Récupérer PDF : GET /leases/{id}/pdf

Étape 1 : Authentification JWT

Authentification : Bearer JWT

curl -X POST https://api.faireplace.com/api/auth/login 
  -H 'Content-Type: application/json' 
  -d '{"email":"[email protected]","password":"..."}'

// Réponse :
{ "access_token": "eyJhbGci...", "expires_in": 3600 }

Étape 2 : Créer le bail et initier la signature

Créer l’immeuble et le lot

POST /places → POST /estates → récupérer les UUIDs

Créer le bail

POST /leases avec les données locataire, loyer et bail_type_id

Initier le workflow de signature

POST /leases/{id}/signature/initiate, déclenche l’envoi des OTP

Écouter les webhooks

Événement lease.signature.completed déclenché quand tous les signataires ont signé

Récupérer le PDF signé

GET /leases/{id}/pdf, disponible dès que le webhook est reçu

Prêt à intégrer la signature en production ?

Documentation interactive, exemples curl, environnement de test sur demande.

Créer mon compte développeur

Référence API