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 (Bachs)

POST /wallet/fund   { "amountKobo": 50000 }
→ { "provider": "bachs", "checkoutUrl": "https://checkout.bachs.io/c/..." }

POST /webhooks/bachs
x-bachs-timestamp / x-bachs-signature
collection.succeeded credits the wallet (idempotent on event id)

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