Virtual Meters

Overview

Save a meter to the account for one-tap repeat electricity purchases, instead of re-entering the meter number and re-validating every time. Saving a meter also reserves it a dedicated funding account, so it can be topped up directly by bank transfer.

Identity verification required

Creating a virtual meter reserves a real funding account, so it requires a verified NIN — same as wallet funding. See Identity Verification.

Save a meter

POST /virtual-meters Requires Auth

bash

curl https://app.slimpay.ng/api/v1/virtual-meters \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "meter_number": "04123456789",
    "meter_name": "Home Meter",
    "disco": "AEDC",
    "vend_type": "PREPAID",
    "transaction_pin": "1234"
  }'

POST /virtual-meters

Reserves a real dedicated funding account on the meter you enter — requires a verified NIN.

meter_number * body

meter_name body

disco * body

vend_type * body

transaction_pin * body

The meter number is validated with the disco before saving — same validation used in Electricity — so a mistyped meter number is rejected before it's stored.

Manage saved meters

Method	Path	Purpose
GET	`/virtual-meters`	List saved meters
GET	`/virtual-meters/{id}`	Get a single meter, with purchase history
PUT	`/virtual-meters/{id}`	Rename or update
DELETE	`/virtual-meters/{id}`	Remove a saved meter

GET /virtual-meters

GET /virtual-meters/{id}

id * path

PUT /virtual-meters/{id}

Updates a real saved meter.

id * path

meter_name body

DELETE /virtual-meters/{id}

Permanently removes this saved meter.

id * path

Funding a meter directly

A funded virtual meter can receive bank transfers directly to its dedicated account — Slimpay confirms the transfer server-to-server and automatically vends electricity for the amount received, without the user needing to open the app.

← Previous

Overview