Developer Documentation
Powerful APIs, SDKs, and webhooks to integrate fuel payments into your applications
Cards API
Issue, block, top-up, and manage cards and groups
Transactions API
Query transactions, refunds, and settlements
Terminal API
Configure terminals, firmware, and routing
Webhooks
Real-time events for authorization, top-ups, and alerts
Quick Start
// Issue a new fuel card
const client = new SmartFuelPay({ apiKey: 'sk_live_...' });
const card = await client.cards.issue({
type: 'physical',
currency: 'EUR',
initialBalance: 1000,
customer: {
name: 'John Doe',
email: 'sales@smartfuelpay.com'
},
limits: {
daily: 500,
transaction: 100
}
});
console.log('Card issued:', card.id);Connected Car APIs
Build Connected Car payment experiences that integrate with in‑vehicle systems and mobile apps. Use our APIs and webhooks to authorize transactions, pair vehicles, and receive real‑time events.
SDKs & Libraries
Webhook Events
Receive real-time notifications for important events in your fuel payment system. All webhooks are delivered via HTTPS POST with signature verification.
// Handle webhook events
app.post('/webhook', async (req, res) => {
const event = req.body;
switch(event.type) {
case 'transaction.authorized':
// Process authorized transaction
await processTransaction(event.data);
break;
case 'card.issued':
// Handle new card issuance
await sendWelcomeEmail(event.data.customer);
break;
case 'fraud.detected':
// Handle fraud detection
await alertSecurityTeam(event.data);
break;
}
res.json({ received: true });
});Developer Resources
Everything you need to build powerful fuel payment integrations
Start Building Today
Join developers worldwide who are building the future of fuel payments