Développeurs et automatisation
Une API REST, des webhooks et la signature électronique pour les systèmes autour de votre portefeuille de prêts
Utilisez l’API pour lire et écrire emprunteurs, prêts et remboursements depuis vos propres logiciels, les webhooks pour être informé des changements au moment où ils se produisent, et la signature électronique intégrée pour faire signer les documents de prêt sans service de signature à part.
curl "https://api.lendbox.io/borrowers?page=1&limit=20" \
-H "Authorization: Bearer live_your_api_key"- Statut
- Intégré
- Formules
- API sur Business, Growth et Enterprise
- Environnements
- Sandbox et production
- Documentation
- api.lendbox.io/docs
Démarrage rapide
Quatre étapes, de zéro à votre première réponse.
- 1Générez une cléDans le tableau de bord, ouvrez API Integration → REST API et sélectionnez Generate New API Key. Conservez-la en lieu sûr. Générer une nouvelle clé désactive l’ancienne : faites-la tourner chaque fois qu’une personne qui y avait accès s’en va.
- 2Choisissez l’environnementSandbox et production sont des environnements distincts, chacun avec son URL de base, ses clés et ses données : https://sandbox-api.lendbox.io et https://api.lendbox.io. Les clés sandbox commencent par sandbox_ et les clés de production par live_. Développez d’abord sur la sandbox.
- 3Envoyez la clé à chaque requêtePassez-la comme jeton bearer dans l’en-tête Authorization. Les codes de réponse renvoyés par l’API sont listés sur la même page du tableau de bord.
- 4Travaillez à partir de la référenceChaque endpoint, paramètre et format de réponse figure dans la documentation publique sur api.lendbox.io/docs. La liste des emprunteurs, par exemple, se pagine avec les paramètres page et limit.
Une clé par espace de travail, affichée avec l’en-tête dans lequel l’envoyer et les deux URL de base.
Ce que les équipes construisent dessus
La plupart des intégrations relèvent de l’un de ces quatre schémas. Chacun utilise des endpoints qui figurent aujourd’hui dans la référence publique.
Intégrer depuis votre propre application
Créez emprunteurs et prêts depuis votre propre site ou votre application d’inscription avec des requêtes POST : une demande reçue hors de Lendbox n’a jamais à être saisie deux fois.
Enregistrer des remboursements venus d’un autre canal
Quand de l’argent arrive par un canal auquel Lendbox ne se connecte pas, comme un compte bancaire ou une paie, imputez le remboursement sur son prêt en un seul appel depuis le système qui l’a vu passer.
Alimenter vos propres rapports
Chargez à intervalles réguliers emprunteurs, prêts et remboursements dans un entrepôt de données ou un outil de BI, et servez-vous des webhooks pour savoir quels enregistrements ont changé entre-temps.
Lancer vos propres flux de travail
Utilisez l’événement de création d’un remboursement pour envoyer un remerciement depuis votre CRM, ou l’événement de création d’un prêt pour ouvrir un dossier dans votre système documentaire.
Comment fonctionnent les clés d’API
- Une clé par espace de travail. Elle agit avec les droits du propriétaire de l’espace de travail : traitez-la comme son mot de passe et gardez-la sur votre serveur, jamais dans un navigateur ou une application.
- Les clés n’expirent pas d’elles-mêmes. Régénérez la clé depuis le tableau de bord pour la révoquer.
- Consulter et gérer la page API est une permission à part entière : vous pouvez la réserver aux personnes qui développent les intégrations.
- L’accès à l’API est inclus dans les formules Business, Growth et Enterprise.
Webhooks : soyez informé des changements au moment où ils se produisent
Ajoutez un webhook dans API Integration → Webhooks : saisissez l’URL d’un endpoint que vous contrôlez et cochez les événements qu’il doit recevoir. Lendbox envoie un POST JSON à cette URL chaque fois que l’un d’eux se produit.
| Enregistrement | Création | Modification | Suppression |
|---|---|---|---|
| Prêt | Oui | Oui | Oui |
| Emprunteur | Oui | Oui | Oui |
| Remboursement | Oui | Oui | Oui |
| Investisseur | Oui | Oui | Oui |
| Produit investisseur | Oui | Oui | Oui |
| Compte investisseur | Oui | Oui | Oui |
POST /your/webhook/endpoint
Content-Type: application/json
X-LendBox-Event: <event name>
X-LendBox-Webhook-ID: <your webhook's id>- X-LendBox-Event
- L’événement déclenché, pour qu’un même endpoint puisse en traiter plusieurs.
- X-LendBox-Webhook-ID
- Lequel de vos webhooks a fait l’envoi.
Construire un récepteur solide
Répondez vite
Lendbox attend dix secondes que votre endpoint réponde. Accusez d’abord réception de l’envoi, et faites le travail long ensuite.
Traitez un envoi comme un signal
Avant d’agir sur un événement, récupérez via l’API le prêt, l’emprunteur ou le remboursement qu’il désigne. Vous obtenez l’enregistrement à jour, et vous confirmez que l’événement est authentique.
Rapprochez à intervalles réguliers
Chaque événement est envoyé une seule fois. Une lecture nocturne via l’API rattrape tout ce que votre endpoint a manqué pendant une interruption, et des traitements idempotents rendent un doublon sans effet.
La signature électronique des documents de prêt, intégrée
Les contrats de prêt, les relevés et les échéanciers de remboursement sont signés dans Lendbox : la copie signée reste sur le prêt, et non dans le compte d’un autre service.
1Créez le modèle
Dans Documents → Loan Templates, rédigez le contrat dans l’éditeur avec des variables pour les informations de l’emprunteur et du prêt, ou chargez un document Word qui contient déjà les variables.
2Indiquez où signer
Sur vos propres modèles, placez une fois les champs de signature et de texte, et chaque prêt qui utilise ce modèle reçoit les mêmes zones de signature. Le Loan Statement et le Repayment Schedule intégrés arrivent avec leurs blocs de signature déjà en place.
3Envoyez les liens
Depuis l’onglet Documents du prêt, choisissez Send for Signature. Signez en votre nom, envoyez par e-mail son lien à l’emprunteur, ajoutez l’agent de crédit, et ajoutez d’autres signataires, comme un proche.
4Recueillez les signatures
Chaque signataire dessine sa signature à l’écran et enregistre. Chaque signature produit une nouvelle version du PDF : la contre-signature fonctionne, et les versions antérieures restent sur le prêt.
Les liens de signature partent vers l’emprunteur, l’agent de crédit et toute autre personne que vous ajoutez.
Chaque lien de signature ne sert qu’une fois et expire au bout de sept jours.
Ce que contient l’historique de signature
Enregistré
- Le nom et le rôle du signataire : emprunteur, agent de crédit ou autre
- Le moment où il a signé
- Chaque version du document, avant et après chaque signature
Non enregistré
- Un code à usage unique : aucun n’est envoyé, c’est donc la possession du lien reçu par e-mail qui identifie le signataire
- L’adresse IP ou l’appareil du signataire
- Un certificat de signature distinct
Les membres de l’équipe peuvent enregistrer leur propre signature dans Settings → Admin → My signature, puis remplir en un clic tous les champs qui leur sont attribués.
Questions fréquentes
- Oui. C’est une API REST, avec une documentation publique sur api.lendbox.io/docs, des environnements sandbox et production distincts, et une authentification par jeton bearer avec une clé que vous générez dans le tableau de bord.
- Business, Growth et Enterprise. La signature électronique est incluse dans toutes les formules.
- Oui. Abonnez-vous à l’événement de création d’un remboursement. Lendbox envoie un POST à votre endpoint quand le remboursement est créé, et vous pouvez ensuite le récupérer via l’API pour obtenir l’enregistrement complet.
- Cela dépend du droit applicable là où vous prêtez et du document : vérifiez auprès de votre conseiller juridique. Lendbox enregistre qui a signé, à quel titre et quand, et conserve chaque version du PDF signé sur le prêt.
- Oui. Le lien de signature s’ouvre dans le navigateur du téléphone et l’emprunteur dessine sa signature du doigt. Il n’y a rien à installer.
- Vous pouvez le développer. L’API lit les emprunteurs, les prêts et les remboursements, et les webhooks signalent les changements : un développeur peut donc les envoyer vers un autre système. Il n’existe pas de connecteur prêt à l’emploi pour QuickBooks ou Xero.
Lendbox dispose-t-il d’une API publique ?
Quelles formules incluent l’accès à l’API ?
Un webhook peut-il me prévenir quand un remboursement est enregistré ?
Les signatures électroniques Lendbox ont-elles une valeur juridique ?
Les emprunteurs peuvent-ils signer sur leur téléphone ?
Puis-je connecter Lendbox à un logiciel de comptabilité via l’API ?
Pour aller plus loin
- Toutes les intégrationsLes intégrations LendboxMobile money en Zambie, rappels par SMS et WhatsApp, import Excel, API REST et webhooks, chacun avec son mode de connexion indiqué.
- Sur le même sujetSécurité et contrôlesPermissions par module et par rôle, validation à quatre yeux et piste d’audit.
- Sur le même sujetPrésentation de la sécuritéChiffrement, hébergement, sauvegardes et signalement d’une vulnérabilité.
- Sur le même sujetCanaux de remboursement des emprunteursLa place des liens de signature parmi le portail, les liens de paiement et les relevés.
- Sur le même sujetComptabilité intégréeLe grand livre sur lequel chaque prêt, remboursement et frais est comptabilisé.
- Sur le même sujetMigration des donnéesImporter emprunteurs et prêts par Excel plutôt que par l’API.
Développez sur Lendbox
Démarrez un essai gratuit, lisez la référence de l’API, et connectez la production quand vous êtes prêt.
Aucune carte requise