Guides

Learn how to integrate Venshack APIs into your applications. These guides cover common use cases and best practices.

Getting Started

Authentication

Learn how to authenticate with the API using API keys, understand test vs production environments, and handle rate limits.

Venshack Platform APIs

⚡ Vending (Venshack)

Purchase prepaid electricity tokens for meters registered to your Venshack organization. Learn the validate → purchase flow, handle transactions, and track vending history.

Pricing: ₦50 for amounts under ₦10,000, 0.5% above

🔌 Vending (Discos)

Purchase prepaid tokens or pay postpaid bills for any supported DISCO meter. No Venshack meter registration required. Handles pending transactions with requery.

Pricing: ₦50 for amounts under ₦10,000, 0.5% above

🔑 Access Codes

Generate and verify visitor access codes for gated communities. The code is sent directly to guests via SMS/email - never exposed in API responses.

Pricing: ₦5 per code created, ₦5 per verification

📊 Meter Management

Register meters for your organization, import in bulk, and track approval status. Meters require admin approval before use.

Pricing: Free

Identity & Verification APIs

🏠 Address Verification API

A standalone proof-of-address product covering supported Nigerian DISCOs. It does not require a Venshack estate, vending transaction, or a meter in your organization's Venshack meter inventory.

Pricing: ₦200 per verification

🔔 Webhooks

Receive real-time event notifications. Configure webhooks via the Dashboard, then receive and verify events when vending completes, access codes are used, meters are approved, and more.

Pricing: Free

Quick Links