REST API · v1.0 · Nigeria

Betavend
API Docs

Programmatic access to airtime, data, electricity and cable TV payments across Nigeria. Simple REST. Bearer token auth. JSON in, JSON out.

Explore API Reference → Quick Start
Base URL https://api.betavend.com/v1

Instant delivery

Airtime and data delivered within 5 seconds. Auto-reversal if delivery fails — wallet is always refunded.

🔑

Bearer token auth

API keys scoped to test or live environments. Per-key IP allowlists and rate limits.

🔁

Idempotent requests

Use X-Idempotency-Key header on all POST requests. Safe to retry on network errors.

📡

Webhooks

Real-time event delivery for transaction status changes. HMAC-signed payloads. Automatic retry.

🇳🇬

All Nigerian networks

MTN, Airtel, Glo, 9Mobile. All DISCOs. DSTV, GOtv, StarTimes. Built for Nigerian infrastructure.

🆔

Request tracing

Every response includes a request_id. Include it in support tickets for instant lookup.

Endpoints at a glance

Account & Wallet
GET/v1/accountGet account details GET/v1/walletGet wallet balance GET/v1/wallet/transactionsWallet transaction history
Services
GET/v1/services/data/plansList available data plans POST/v1/services/data/purchasePurchase a data bundle POST/v1/services/airtimePurchase airtime POST/v1/services/electricityPay electricity bill POST/v1/services/tvRenew cable TV subscription
Transactions
GET/v1/transactionsList all transactions GET/v1/transactions/{reference}Get a single transaction
API Keys
GET/v1/keysList your API keys POST/v1/keysCreate a new API key DELETE/v1/keys/{id}Revoke an API key