Skip to main content

RESSOURCES

API

Our real-time financing API

The Novalend API lets you integrate a financing module into your website or software.

Our REST API lets you automate the financing of tangible or intangible assets. Take advantage of its quick and easy integration and create a project that meets your needs, expectations and objectives.

Give us your ideas!

Our technical team can also develop your customised project. Don’t hesitate to contact us to discuss your requirements.

Would you like to try out our API?

Integrate Novalend’s real-time financing technology into your product

General

We provide you free of charge with a secure test area (sandbox) in parallel with the production environment. This space will allow you to test your prototypes and any other integration examples.

The REST API uses HTTP headers for authorisation

  • Authorization : Authorization: Basic your_token
  • Sandbox API URL : Sandbox API URL: https://test.novalend.com/api/
  • Live API URL : Live API URL: https://www.novalend.com/api/

Request format

Requests must be made in JSON. The Content-type header must be set accordingly to Content-type: application/json

Response format

Responses are formatted in json

Standard API return code

Code Description
200 OK
400 Éligibilities : This value is not a valid SIREN code.
Quotation : Bad request, in the response you will find a reference to the field causing this error.

API eliglible

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 Allows you to obtain the rents for a given product.
URL https://test.novalend.com/api/quotation
Method POST
Parameters 1. sirenClient Siren of the client (Integer)
2. sirenSupplier Siren of the supplier (Integer)
3. equipmentType EquipmentType see table below (Integer)
4. duration 12|18|24|30|36|42|48|54|60 months, depending on equipmentType (Integer)
5. period Period value between 1 and 4 for monthly, quarterly, half-yearly, annual. (Interger)
6. amount Value in euros, between 500 and 50000 (Float)
7. condition New | Used (String)
8. intangible Intangible amount (Float)
9. rebillable Amount to be rebilled to the supplier (Float)

Correspondences for equipmentType

ID Name Min. duration Max. duration
1. Handling and lifting 24 72
2. Construction equipment 24 60
3. Cleaning and waste management 24 60
4. Medical equipment 24 60
5. Office automation, computing 24 60
6. Other equipment and tools 24 72
7. Software 12 36
8. Working environment 12 48
9. Vehicles 24 72
Return A JSON object containing the associated information or errors
Example of a JSON response
Exemple réponse JSON Exemple réponse JSON

The REST API uses HTTP headers for authorisation

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