Copy page

Guides

Webhooks

Concrètement, il n'y a ni URL de rappel à enregistrer, ni signature à vérifier, ni file de réémission. Toute intégration se fait en interrogeant l'API.

En attendant : interroger correctement

Trois événements intéressent la plupart des intégrations. Voici comment les suivre sans webhook.

Une demande de crédit a-t-elle été approuvée ?

Code
GET /v1/papi/credit-requests?status=PENDING_APPROVAL

Interrogez à un rythme humain : une approbation Instafuel se compte en heures, pas en secondes. Un passage toutes les 15 minutes suffit largement, et un rappel quotidien sur les demandes proches de leur expiration (7 jours) évite les mauvaises surprises.

De nouvelles transactions sont-elles arrivées ?

Code
GET /v1/papi/transactions?from=2026-08-30&to=2026-08-31

Bornez sur une période, dédupliquez sur ref à l'arrivée, et conservez le ref le plus récent que vous avez traité. Une transaction déjà vue ne doit pas déclencher deux fois votre traitement métier — c'est de toute façon la bonne discipline, webhook ou pas.

Où en est une déclaration de versement ?

Code
GET /v1/papi/credit-requests/{id}

PENDING_APPROVAL → APPROVED ou REJECTED. Un rapprochement bancaire se compte en heures, pas en secondes : une interrogation toutes les 15 minutes suffit largement. Voir Limites et quotas.

Ce qu'il faut prévoir dès maintenant

Si vous voulez pouvoir brancher des webhooks sans réécrire votre intégration le jour où ils existeront :

• Rendez vos traitements idempotents. Traiter deux fois la même transaction ne doit rien casser. C'est la condition nécessaire à toute livraison d'événements, qui est toujours « au moins une fois ».
• Isolez la réception. Faites passer les données par une fonction d'ingestion unique, alimentée aujourd'hui par votre boucle d'interrogation. Un webhook n'aura qu'à appeler la même fonction.
• Gardez une trace de ce que vous avez traité, par ref. C'est ce qui vous permettra de réconcilier après une coupure, dans les deux modèles.

Être prévenu

Demandez à votre interlocuteur Instafuel d'être informé quand les webhooks seront disponibles. Les changements de l'API partenaire sont annoncés aux partenaires intégrés avant leur mise en production.