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

Request access

Documentation
Exemples

In this article

General

API éligibles

API quotation

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

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

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