Notre API de financement en temps réel
L'API Novalend vous permet d'intégrer une brique de financement dans votre site ou logiciel.
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.
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 |
Eligibilities : 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 Eligibilities :
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 |
|
Retour |
Un objet JSON qui contient les informations ou erreurs associés
Exemple de réponse JSON { "criterias": { "public": { "label": "La société est public", "code": "public", "value": "542051180", "result": false } , "tradingfollow": { "label": "La société dispose de 2 liasses fiscales consécutives", "code": "tradingfollow", "value": "2017 - 2016", "result": true }, "turnover": { "eval": "$value >= 400000", "label": "La société a un chiffre d'affaire supérieur ou égal à 400.000 Euros", "message": "La société a un chiffre d'affaire inférieur à 400 000 Euros", "code": "turnover", "value": "7085000000", "result": true } , "financial": { "eval": "$value > 0", "label": "La société possède des données financières", "code": "financial", "value": 5, "result": true } }, "name": "TOTAL SA", "isEligible": true } |
API Quotation :
Description | Permet d'obtenir les loyers d'un produit donné. | ||||||||||||||||||||||||||||||||||||||||
URL | https://test.novalend.com/api/quotation |
||||||||||||||||||||||||||||||||||||||||
Méthode | POST | ||||||||||||||||||||||||||||||||||||||||
Paramètres |
correspondances pour equipmentType
|
||||||||||||||||||||||||||||||||||||||||
Retour |
Un objet JSON qui contient les informations ou erreurs associés
Exemple de réponse JSON { "created_at": "2018-09-05T15:24:48+0200", "siren_client": "542051180", "siren_supplier": "824608475", "equipment_type": { "name": "Manutention et levage" }, "condition": "Neuf", "duration": 36, "amount": 935.5, "intangible": 0, "rebillable": 200, "score": 5.5, "period": { "id": 1, "name": "Mensuelle" }, "quantity": 1, "rent": 39, "rents": [ { "duration": 24, "rent": 52, "url": "https://test.novalend.com/quotation/createQuotation/5295?duration=24" }, { "duration": 30, "rent": 44, "url": "https://test.novalend.com/quotation/createQuotation/5295?duration=30" }, { "duration": 36, "rent": 39, "url": "https://test.novalend.com/quotation/createQuotation/5295?duration=36" }, { "duration": 42, "rent": 35, "url": "https://test.novalend.com/quotation/createQuotation/5295?duration=42" }, { "duration": 48, "rent": 33, "url": "https://test.novalend.com/quotation/createQuotation/5295?duration=48" } ], "application_fee": 50, "messages": "" } |
1. Code PHP pour tester l'égibilité d'une société via son SIREN
$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.";
2. Code PHP pour obtenir une quotation pour le leasing d'un produit
$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"]."€";
Détails de la tarification
L'utilisation de l'API est gratuite* les 3 premiers mois suivants votre inscription, puis est facturée 5 euros HT par requête.
* dans la limite de 200 requêtes sur la période.
Assistance et contrat SLA
Nous offrons un support technique pour la mise en place de l'API.
Contrat SLA : nous garantissons le fait que les instances du service Gestion des API exécutées au niveau standard répondront aux demandes d’opérations au moins 99,9 % du temps.