Webhooks
Not available
The partner API emits no webhooks today. No date is announced: we will not promise one we cannot keep.
This page exists so you do not have to search: there is nothing to hook up, and nothing to wait for right now.
Concretely, there is no callback URL to register, no signature to verify, no redelivery queue. Every integration works by polling the API.
In the meantime: poll properly
Three events matter to most integrations. Here is how to track them without webhooks.
Has a credit request been approved?
Code
Poll at a human rhythm: an Instafuel approval takes hours, not seconds. Every 15 minutes is plenty, and a daily sweep over requests nearing their 7-day expiry avoids bad surprises.
Have new transactions landed?
Code
Bound the period, deduplicate on ref on arrival, and keep the most recent ref you have processed. A transaction already seen must not trigger your business logic twice — which is the right discipline anyway, webhooks or not.
Where does a payment declaration stand?
Code
PENDING_APPROVAL → APPROVED or REJECTED. A bank reconciliation takes hours, not seconds: polling every 15 minutes is plenty. See Limits and quotas.
What to prepare now
If you want to be able to plug webhooks in without rewriting your integration the day they exist:
- Make your processing idempotent. Processing the same transaction twice must break nothing. That is the precondition for any event delivery, which is always "at least once".
- Isolate ingestion. Funnel data through a single ingestion function, fed today by your polling loop. A webhook will only have to call the same function.
- Keep track of what you have processed, by
ref. That is what lets you reconcile after an outage, in either model.
Getting notified
Ask your Instafuel contact to be told when webhooks become available. Partner API changes are announced to integrated partners before they go to production.