Skip to main content

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

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
Exemple réponse JSON Exemple 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
Exemple réponse JSON Exemple 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"]."€";