VestGas is the delivery and intelligence layer for LPG. Fintechs, governments, estates and gas plants plug into one wallet-funded API and offer gas the way they already offer airtime — a customer taps “buy gas,” pays, and we handle onboarding, delivery, live agent tracking and refill prediction end to end. You are the storefront; we run every offline step.
Free ₦5,000 live credit on signup · ₦1M sandbox wallet · No card required
# One call: find/create the customer, charge, schedule, track curl https://vestgas.com/partner.php?api=v1/vas/purchase \ -H "Authorization: Bearer sk_live_********" \ -d '{ "name": "Aisha Bello", "phone": "08012345678", "gas_size_kg": 12.5, "delivery_category": "priority", "latitude": 9.0575, "longitude": 7.4450 }'
Two sides of one network. Aggregators bring the customers and the payment rails; gas plants and their agents fulfil on the ground. VestGas is the layer in between that makes gas a one-tap purchase.
Add gas next to airtime, data and electricity. Your customer taps buy, pays from their wallet, and we deliver. The VAS endpoint does it in one call — no new account for the user.
Run clean-cooking programmes with measurable delivery. Issue LPG as digital vouchers, track fulfilment household by household, and see the climate impact in the data.
Give residents scheduled doorstep refills and predictable pricing. One integration covers the whole estate, with delivery windows and agent tracking built in.
Turn your plant into a demand engine. Onboard customers with the field app, log refills, bind cylinders by barcode, and let our prediction model tell you who needs gas next.
Your app is the storefront. We handle delivery, agent logistics, payment reconciliation, live tracking and the prediction model — every offline step, at zero operational risk to you.
POST /v1/vas/purchase
The bill-payment primitive. Send name, phone, gas size and destination; we find or create the customer, charge your wallet, schedule the delivery and return a tracking link — the way you already sell airtime. Existing customers are auto-claimed, so it is truly one call.
GET /v1/vas/track/<ref>
Your customer watches the delivery move. The field app streams the agent's GPS in the background; the tracking endpoint returns a Google Maps link that always points at the agent's latest position, plus the delivery status timeline.
GET /v1/pricing/delivery
Standard is free and same-day. Priority (1h), Express (45m) and Rush (30m) guarantee same-day windows for a per-kg premium. Prices are partner-specific and can be tuned per SLA.
GET /v1/customers/<id>/prediction
Every purchase returns the customer's estimated run-out date. A refill-driven model tells you who needs gas next — so aggregators can prompt reorders before the cylinder runs dry.
Top up your VestGas wallet via Paystack. Every API call that creates a refill or subscription debits the wallet at predictable, pre-agreed prices. You keep all end-customer billing — we never touch their cards.
Every account starts with a ₦1,000,000 sandbox wallet and a
sk_test_ key. Test-mode refills are simulated end-to-end —
no LPG actually moves, but every API contract behaves exactly like live.
We currently deliver across 32 FCT districts including Wuse, Maitama, Asokoro, Garki, Wuye, Jabi, and Lugbe. Customer PII is partner-scoped at the database layer — your data is yours.
Default pricing matches retail. We honor partner-specific pricing arrangements via overrides on your account.
On-demand 12.5kg refills. Scheduled or immediate. No commitment.
Recurring weekly or fortnightly delivery. Five tiers to match any household.
For partners shipping >500 refills/month. Custom wholesale rates, priority dispatch, dedicated coverage zones.
Idempotency keys on every write. Webhook signatures use HMAC-SHA256.
Errors include a stable code,
human message, and a
link to docs. Full reference is in your dashboard once you sign up.
/v1/customers
Create a customer
/v1/customers/<id>
Retrieve one
/v1/customers/<id>
Update fields
/v1/refills
Schedule a refill
/v1/customers/<id>/refills
Refill history
/v1/customers/<id>/locations
Refill GPS history
/v1/customers/<id>/location
Update GPS manually
/v1/subscriptions
Start a subscription
/v1/customers/<id>/prediction
Predict runout
/v1/customers/<id>/usage
Log telemetry event
/v1/wallet
Check balance
# Create a customer in test mode curl https://vestgas.com/partner.php?api=v1/customers \ -H "Authorization: Bearer sk_test_********" \ -H "Idempotency-Key: signup-92a31f" \ -d '{ "external_id": "user_4231", "first_name": "Aisha", "phone": "08012345678", "household_size": 4, "cylinder_kg": 12.5, "cook_frequency": "daily", "address": { "house_number": "23", "street": "1st Avenue", "area": "Wuse", "city": "Abuja" } }' # Response: 201 Created { "status": "success", "data": { "object": "customer", "id": "V00000423", "first_name": "Aisha", "phone": "08012345678", "created_at": "2026-05-05T13:42:11Z" } }
Sign up in 60 seconds. Get a sandbox wallet, test API key, and full dashboard access. No card required, no sales call needed.