RESSOURCES

API

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.

Vous souhaitez essayer notre API ?

Intégrez la technologie de financement en temps réel Novalend dans votre produit

Demander un accès

Documentation
Exemples

Dans cet article

Généralités

API éligibles

API quotation

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"]."€";