Getting Started

Welcome on board, in this section we'll walk you through getting up and running on our Airtime API. This section walks you through the prerequisite activities required before actually making API calls to our system.

Signup For An Account

Upon your arrangement at Teleport Business Team, a new account gets created for you at Teletop portal (teletop.et). Following this you should receive a confirmation email in your inbox having the instructions to activate and access your account. An account activation link will be sent in an email. The activation link expires within 24 hours of it being sent, and you will need to register for another account.

Setup Your API Key

Once you are able to activate your account and login to our portal, navigating to "https://teletop.et/manage-apis" Menu will present you the place where you can manage your API access key.

In the manage api page, you can

Enable / Disable API access to your Account

Setup your API access IP Address / URL endpoint

Generate API and obtain API Key

Note

1. Make sure your Api Key Integration is Enabled.
2. Your Api Access Details should be copied and kept securely.
3. Update Merchant Url to the correct URL / IP Address at which your system originates the API calls NOTE Valid accepted URLs are IP addresses (format: xxx.xxx.xxx.xxx) or a FQDN

The Gateway URL

Teletop's API are web-based APIs with request and response messages. Use the following Base URLs for all API endpoint and environment context, unless specified explicitly.

Table 1: Base Gateway URL

ENVIRONMENT	HTTPS BASE REQUEST URL
Production Environment	AUTH_BASE_URL: BASE_URL: https://api.teletop.et/api/v1/client
Test Environment	AVAILABLE ON REQUEST