# Webhooks

<Callout type="caution" title="Non disponibles">
  L'API partenaire n'émet aucun webhook aujourd'hui. Aucune date n'est annoncée : nous n'en promettrons pas une que nous ne tiendrions pas.

  Cette page existe pour que vous n'ayez pas à chercher : il n'y a rien à brancher, et rien à attendre pour l'instant.
</Callout>

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 ?

```http title="Endpoints"
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 ?

```http title="Endpoints"
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 ?

```http title="Endpoints"
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](/guides/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.