KNOS Developer Platform API

REST API for prepaid wallet purchases — airtime, data, voice, AFA, ECG, and future products. Same transaction engine as the KNOS storefront. JSON in, JSON out.

Introduction

Partners authenticate with a Bearer API key. Create applications in the Developer portal, integrate against sandbox, then request production approval from KNOS Ops.

Requests use Authorization: Bearer knos_sandbox_… or knos_production_…. The key prefix selects the environment; sandbox never calls live telecom providers.

Base URL

Environment	Base URL
Sandbox & Production	`https://confident-elephant-309.convex.site/v1`

Environment is determined by the API key, not a separate host. Production keys require Ops-approved applications.

Available services

Service	Method	Description	Reference
List products	GET	Scoped catalog: products, packages, operators	Docs
Product detail	GET	Single product and packages	Docs
Wallet balance	GET	Available and held prepaid balance	Docs
Create transaction	POST	Airtime, data, voice, AFA, ECG and future products	Docs
Get transaction	GET	Full transaction envelope	Docs
Transaction status	GET	Thin status poll	Docs
ECG meter lookup	POST	Resolve meters before ECG purchase	Docs
Number verification	POST	Async MSISDN verification batch	Docs
Test webhook	POST	Send a signed test delivery	Docs

Quick start — airtime

After Ops enables developer access and you create an application, copy the sandbox key and call create transaction:

POSThttps://confident-elephant-309.convex.site/v1/transactions

Request

curl -sS https://confident-elephant-309.convex.site/v1/transactions \  -H "Authorization: Bearer knos_sandbox_YOUR_KEY" \  -H "Content-Type: application/json" \  -d '{    "idempotencyKey": "550e8400-e29b-41d4-a716-446655440000",    "product": "airtime",    "productId": "airtime-mtn",    "amount": 1,    "beneficiary": "0241234567"  }'

201 Created

{  "transaction": {    "id": "511260",    "reference": "511260",    "status": "pending",    "kind": "purchase",    "environment": "sandbox"  }}