Skip to main content

USSD Webhook Integration

Kairos Afrika’s USSD service works as a webhook-based integration. We don’t provide endpoints for you to call. Instead, you provide us with your webhook endpoint, and we push USSD session data to your endpoint when users interact with your USSD application.

How It Works

  1. You provide the endpoint: You give us your webhook URL (e.g., https://yourapp.com/ussd)
  2. We push requests: When users dial your USSD code, we send the session data to your endpoint
  3. You respond: Your endpoint processes the request and returns the appropriate response
  4. We handle the display: We show your response to the user on their mobile device

Integration Flow

Example Use Cases

  • Balance checks and account inquiries
  • Airtime top-up and bill payments
  • Service subscriptions and activations
  • Customer support menus
  • Mobile banking operations

Webhook Documentation


The endpoint URL https://example.com/ussd used in examples is just a placeholder. Replace it with your actual webhook endpoint URL.