Retailer API

OTP Officials talks to HeroSMS on your behalf. Retailers authenticate with x-api-key after generating a key in the dashboard.

Base URL

Your Cloud Function URL, for example https://REGION-PROJECT.cloudfunctions.net/kinlo-api

Buy a number

POST /activations
x-api-key: knlo_...
{ "service": "wa", "country": 16 }

Poll for the OTP

GET /activations/:id
x-api-key: knlo_...

Wallet

POST /wallet/fund   { "amountKobo": 50000 }
→ { "checkoutUrl": "https://…" }

Wallet credits after the payment processor confirms the collection (idempotent).

Service codes follow the HeroSMS / SMS-Activate set (wa WhatsApp, tg Telegram, go Google). Country IDs match that same table.