📬

Subscribe to API change notifications by emailing support@betavend.com with subject "Subscribe to API changelog".

v1.0.0
May 2, 2026 — Initial Release

Added GET /v1/account — returns authenticated user details

Added GET /v1/wallet — returns wallet balance in NGN

Added GET /v1/wallet/transactions — paginated wallet transaction history

Added GET /v1/services/data/plans — list available data plans per network

Added POST /v1/services/data/purchase — purchase data bundle

Added POST /v1/services/airtime — purchase airtime

Added POST /v1/services/electricity — pay electricity bill

Added POST /v1/services/tv — renew cable TV subscription

Added GET /v1/transactions — list all service transactions

Added GET /v1/transactions/{ref} — get single transaction by reference

Added GET /v1/keys — list API keys

Added POST /v1/keys — create new API key (max 5 per account)

Added DELETE /v1/keys/{id} — revoke API key

Added Bearer token authentication via bv_live_* and bv_test_* key prefixes

Added Idempotency key support via X-Idempotency-Key header on all POST requests

Added request_id on every response for distributed tracing

Added Rate limiting: 60 requests/minute per API key

Added CORS support for app.betavend.com, business.betavend.com, docs.betavend.com

Added Stable error codes (e.g. wallet.insufficient_funds) — codes are permanent, messages may evolve

Added Auto-reversal: failed transactions automatically refund wallet within 5 minutes

📋

This is the initial public API release. All endpoints are considered stable. We follow semantic versioning — breaking changes will increment the major version and be announced 30 days in advance.