USSD Service Introduction

Our USSD (Unstructured Supplementary Service Data) Service enables you to create interactive, menu-based applications accessible via simple dial codes (like *123#) on any mobile phone, without requiring internet access. It's ideal for reaching users in areas with limited connectivity for tasks like surveys, information retrieval, balance checks, or simple service interactions.

This section guides you through the necessary setup to start building and deploying your USSD application using our platform.

USSD Requirements & Setup

Before you can launch your USSD service, please ensure the following prerequisites are met:

  1. Account Creation:

    An active main account on our platform is required. If you don't have one, sign up here.

  2. Company Setup:

    Configure your primary company profile, or create a specific one if this USSD service is tied to a particular entity.

  3. Application Creation & Configuration:
    • Configure an 'App' instance within your dashboard specifically for your USSD service.
    • Configure USSD Webhook URL: This is a critical step. Provide a secure endpoint URL where our platform will send user requests (e.g., menu selections) and session information. Your application logic will reside at this URL to process requests and send back the appropriate USSD menu response.
    • Define USSD Menu Flow: Your application logic (hosted at the webhook URL) is responsible for defining the entire menu structure, handling user input, and managing the session state.
  4. API Key Generation:
    • Generate an API Access Key specifically for the App dedicated to your USSD service.
    • Securely store the Access Key, as it cannot be retrieved after generation.
    • That Access Key will be used to your backend to make calls on our apis like genelate ussd codes and get ussd codes.
  5. USSD Session Purchase:

    USSD interactions often have a per-session cost associated with the Mobile Network Operators. Ensure you have purchased sufficient USSD session bundles or have adequate account balance to cover the expected usage of your service. Check our pricing page or contact support for details.

With these steps completed, you are ready to consult the API reference and webhook documentation to implement your USSD application's logic.