Entreprises
Le portefeuille — lecture, enrôlement, mise à jour.
Lister les entreprises du portefeuille
Scope requis : COMPANIES_READ.
query Parameters
pageperPagePlafonné à 100.
searchFiltre sur le nom, insensible à la casse.
statusLister les entreprises du portefeuille › Responses
Liste paginée
Demander l'enrôlement d'une entreprise
Scope requis : COMPANIES_WRITE.
Répond 202, pas 201. Aucune entreprise n'existe à l'issue de cet appel :
une demande d'approbation est ouverte, qu'un opérateur Instafuel doit valider.
La demande expire au bout de 7 jours.
rccm et nif sont obligatoires : sans immatriculation, la même entreprise
réelle pourrait être enrôlée deux fois, avec deux wallets distincts.
Headers
X-Idempotency-KeyValeur unique par opération — un UUID convient. Rejouée à l'identique dans les 24 h, la requête renvoie la première réponse au lieu de créer un doublon.
Demander l'enrôlement d'une entreprise › Request Body
nameemailphoneNumberrccmRegistre du commerce. Normalisé en majuscules avant contrôle d'unicité.
nifIdentifiant fiscal. Normalisé en majuscules avant contrôle d'unicité.
headquartersAddressDemander l'enrôlement d'une entreprise › Responses
Demande enregistrée, en attente de validation Instafuel
Mettre à jour une entreprise
Scope requis : COMPANIES_WRITE.
Modification partielle : seuls les champs fournis sont écrits. Les champs
acceptés sont name, email, phoneNumber, rccm, nif et
headquartersAddress — tout autre champ est ignoré.
path Parameters
companyIdIdentifiant d'une entreprise de votre portefeuille.
Headers
X-Idempotency-KeyValeur unique par opération — un UUID convient. Rejouée à l'identique dans les 24 h, la requête renvoie la première réponse au lieu de créer un doublon.
Mettre à jour une entreprise › Request Body
nameemailphoneNumberrccmnifheadquartersAddressMettre à jour une entreprise › Responses
Entreprise mise à jour