12,90 €
Par bail signé, tous signataires compris, sans abonnement obligatoire
SMS
Code à usage unique pour chaque signataire
PAdES
Format B-LTA, horodaté par Universign
REST
API documentée, spécification OpenAPI publique
⚡ La signature par API, en bref
- Authentification par clé d'API, créée depuis votre compte
- Le bail est créé, mis en PDF puis envoyé en signature par l'API
- Chaque signataire signe depuis son e-mail, avec un code SMS
- Votre logiciel suit l'avancement en interrogeant le statut, puis récupère le PDF signé et sa preuve
Ce que vous n'avez pas à construire
Une signature de bail recevable demande plus qu'un champ « signer ici » : identifier chaque signataire, sceller le document pour qu'il ne puisse plus être modifié, l'horodater par un tiers, et conserver un dossier de preuve. FairePlace fournit une signature électronique avancée au sens de l'article 26 du règlement eIDAS, au format PAdES-B-LTA : certificat Certinomis, horodatage qualifié Universign, et preuves de validité intégrées au PDF pour qu'il reste vérifiable dans le temps.
Authentification
Créez une clé d'API depuis votre compte FairePlace et joignez-la à chaque requête, comme décrit dans la page Authentification de la documentation. Toutes les routes ci-dessous sont sous https://api.faireplace.com/api/v1.
Le parcours, étape par étape
01
Créer le bail
POST /leases avec le logement, les parties, le loyer et le type de bail
02
Générer le PDF
POST /leases/{id}/pdf produit le contrat à partir des données du bail
03
Vérifier que le bail peut partir
GET /leases/{id}/signature/preflight liste ce qui manque avant l'envoi
04
Régler l'envoi
GET /leases/{id}/payment/signature-status indique si l'envoi est couvert par votre plan ; sinon, POST /leases/{id}/payment/create-checkout-session (12,90 € par bail signé)
05
Lancer la signature
POST /leases/{id}/signature/initiate : chaque signataire reçoit son invitation par e-mail et signe avec un code reçu par SMS
06
Suivre l'avancement
GET /leases/{id}/signature/status renvoie l'état de chaque signataire. Interrogez-le à intervalle régulier : l'API n'envoie pas de notification à votre logiciel
07
Récupérer le bail signé et la preuve
GET /leases/{id}/signature/proof renvoie le lien du PDF signé et le dossier de preuve (JSON)
Savoir quand le bail est signé
L'API ne rappelle pas votre serveur quand la signature est terminée. Interrogez /signature/status à intervalle raisonnable, par exemple toutes les quelques minutes tant que des signataires n'ont pas signé. De leur côté, le bailleur et les signataires reçoivent un e-mail quand le bail est entièrement signé. Pour relancer un signataire, POST /leases/{id}/signature/resend/{signer_type} renvoie son invitation.