L’API Novalend vous permet d’intégrer une brique de financement dans votre site ou logiciel.
RESSOURCES
Nos APIs de financement en temps réel
Notre API REST vous permet d’automatiser le financement de biens matériels ou immatériels. Bénéficiez de son intégration facile et rapide et créez un projet qui réponde à vos problématiques, attentes & objectifs.
Confiez-nous vos idées !
Notre équipe technique peut également développer, pour vous, votre projet sur mesure. N’hésitez pas à nous contacter pour en discuter avec nous.
Vous souhaitez essayer notre API ?
Intégrez la technologie de financement en temps réel Novalend dans votre produit
Généralités
Nous mettons à votre disposition gratuitement un espace de test sécurisé (sandbox) en parallèle de l’environnement de production. Cet espace vous permettra de tester vos prototypes et tout autre exemple d’intégration.
L’API REST utilise les en-têtes HTTP pour l’autorisation
- Authorization : Basic votre_token
- Sandbox API URL : https://test.novalend.com/api/
- Live API URL : https://www.novalend.com/api/
Request format
Les demandes doivent être effectuées en JSON. L’en-tête Content-type doit être défini en conséquence sur Content-type: application/json
Format de réponse
Les réponses sont formatées en json
Code de retour standard de l’API
Code | Description |
---|---|
200 | OK |
400 | Éligibilities : Cette valeur n'est pas un code SIREN valide. Quotation : Bad request, dans la réponse vous trouverez une mention du champ causant cette erreur. |
API éligibles
Description | Permet de tester l’éligibilité d'un client via son numéro SIREN. |
URL | https://test.novalend.com/api/eligibilities |
Méthode | POST |
Paramètres | 1. siren du client (integer) |
Retour | Un objet JSON qui contient les informations ou erreurs associé Exemple de réponse JSON |
API quotation
Description | Permet d'obtenir les loyers d'un produit donné. |
URL | https://test.novalend.com/api/quotation |
Méthode | POST |
Paramètres |
1. sirenClient siren du client (Integer) 2. sirenSupplier siren du fournisseur (Integer) 3. equipmentType voir tableau ci-dessous (Integer) 4. duration 12|18|24|30|36|42|48|54|60 mois, dépendant de equipmentType.(Integer) 5. period valeur entre 1 et 4 pour mensuelle, trimestrielle, semestrielle, annuelle. (Interger) 6. amount valeur en euros, entre 500 et 50000 (Float) 7. condition Neuf | Occasion (String) 8. intangible montant intangible (Float) 9. rebillable Montant à refacturer au fournisseur (Float) |
Correspondances pour equipmentType
ID | Name | Durée min. | Durée max. |
1. | Manutention et levage | 24 | 72 |
2. | Matériel de BTP | 24 | 60 |
3. | Nettoyage et gestion déchets | 24 | 60 |
4. | Matériel médical | 24 | 60 |
5. | Bureautique, informatique | 24 | 60 |
6. | Autres équipements et outillages | 24 | 72 |
7. | Logiciels | 12 | 36 |
8. | Environnement de travail | 12 | 48 |
9. | Véhicules | 24 | 72 |
Retour | Un objet JSON qui contient les informations ou erreurs associé Exemple de réponse JSON |
L’API REST utilise les en-têtes HTTP pour l’autorisation
$token="votre_token_ici";
$sirenDeVotreClient="824236988"; // code SIREN de Novalend pour l'exemple
$json='{"sirenClient":"'.$sirenDeVotreClient.'"}';
$crl = curl_init("https://test.novalend.com/api/eligibilities");
$headr = array();
$headr[] = 'Accept: application/json';
$headr[] = 'Content-type: application/json';
$headr[] = 'Authorization: Basic '.$token;
curl_setopt($crl, CURLOPT_HTTPHEADER,$headr);
curl_setopt($crl, CURLOPT_POST,true);
curl_setopt($crl, CURLOPT_RETURNTRANSFER,true);
curl_setopt($crl, CURLOPT_POSTFIELDS, $json);
$curl_response = curl_exec($crl);
curl_close($crl);
$response=json_decode($curl_response,true);
if ($response["code"]==400)
{
echo "Cette valeur n'est pas un code SIREN valide.";
exit();
}
if ($response["isEligible"])
echo "La société ".$response["name"]." est éligible au leasing.";
else
echo "Le résultat de l'analyse financière de la société ".$response["name"]." ne nous permet pas de formuler une offre en ligne.";
L’API REST utilise les en-têtes HTTP pour l’autorisation
$token="votre_token_ici";
$sirenDeVotreClient="542051180"; // Code SIREN de TOTAL SA pour l'exemple
$sirenSupplier="824236988" // Mettre votre SIREN. Ici code SIREN de Novalend pour l'exemple
$json='{
"sirenClient":"'.$sirenDeVotreClient.'",
"sirenSupplier":"'.$sirenSupplier.'",
"equipmentType":1,
"duration":48,
"period":1,
"amount":15000,
"condition":"Neuf",
"intangible":0,
"rebillable":200
}';
$crl = curl_init("https://test.novalend.com/api/quotations");
$headr = array();
$headr[] = 'Accept: application/json';
$headr[] = 'Content-type: application/json';
$headr[] = 'Authorization: Basic '.$token;
curl_setopt($crl, CURLOPT_HTTPHEADER,$headr);
curl_setopt($crl, CURLOPT_POST,true);
curl_setopt($crl, CURLOPT_RETURNTRANSFER,true);
curl_setopt($crl, CURLOPT_POSTFIELDS, $json);
$curl_response = curl_exec($crl);
curl_close($crl);
$response=json_decode($curl_response,true);
if ($response["code"]==400)
{
echo "Bad request, in the response, you will see which field is missing or invalid.";
exit();
}
if ($response["rent"])
echo "Le loyer est de ".$response["rent"]."€";