Wallet
Soldes Fuelz, écritures et déclarations de versement.
Solde du wallet d'une entreprise
Scope requis : WALLET_READ.
availableFcfa = balanceFcfa − heldFcfa. Le montant retenu correspond aux
pleins pré-autorisés dont le volume réel n'est pas encore confirmé.
path Parameters
companyIdIdentifiant d'une entreprise de votre portefeuille.
Solde du wallet d'une entreprise › Responses
Wallet
Écritures du wallet
Scope requis : LEDGER_READ.
path Parameters
companyIdIdentifiant d'une entreprise de votre portefeuille.
query Parameters
pageperPagePlafonné à 100.
fromBorne inférieure, date ISO 8601.
toBorne supérieure, date ISO 8601.
typeÉcritures du wallet › Responses
Écritures paginées, de la plus récente à la plus ancienne
Téléverser une preuve de versement
Scope requis : CREDIT_REQUEST_WRITE.
Étape préalable obligatoire à toute demande de crédit : celle-ci exige les identifiants renvoyés ici. Jusqu'à 3 fichiers, 10 Mo chacun.
Seul endpoint de l'API en multipart/form-data.
path Parameters
companyIdIdentifiant d'une entreprise de votre portefeuille.
Téléverser une preuve de versement › Request Body
filesTéléverser une preuve de versement › Responses
Preuves enregistrées
Déclarer un versement à créditer
Scope requis : CREDIT_REQUEST_WRITE.
Répond 202, pas 200 : rien n'est crédité. Vous déclarez qu'un versement
a eu lieu ; seul Instafuel constate l'encaissement et approuve. Le solde ne
bouge qu'ensuite. La demande expire au bout de 7 jours.
Une preuve est obligatoire — téléversez-la d'abord via
POST …/wallet/credit/proof et reprenez les identifiants obtenus dans
proofIds.
clientReference est votre référence de versement (numéro de virement,
identifiant Mobile Money). Elle est préfixée côté serveur par votre identifiant
d'apporteur, ce qui vous évite toute collision avec un autre partenaire.
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.
Déclarer un versement à créditer › Request Body
amountFcfasourceNature réelle du versement constaté.
clientReferenceVotre référence de versement. Préfixée côté serveur, sans collision possible avec un autre partenaire.
proofIdsIdentifiants renvoyés par POST …/wallet/credit/proof.
noteDéclarer un versement à créditer › Responses
Déclaration enregistrée, en attente de validation Instafuel
Suivre vos déclarations de versement
Scope requis : WALLET_READ — suivre l'état de ses demandes est une lecture.
Ne renvoie que les demandes émises par votre organisation.
query Parameters
statuscompanyIdSuivre vos déclarations de versement › Responses
Demandes, de la plus récente à la plus ancienne