Changelog
All notable changes to the Betavend API are documented here. Breaking changes are clearly marked.
Subscribe to API change notifications by emailing support@betavend.com with subject "Subscribe to API changelog".
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.