1. Home
  2. Docs
  3. Getting started
  4. Service Providers access to Bizao APIs

Service Providers access to Bizao APIs

Bizao gateway gives you an access to a catalog of one-time REST APIs. It provides you end-points to process your business traffic in different Telco-operators in Africa.

To use this API, the service provider needs to sign-up to the service and subscribe to the Bizao API.

So far, the sign-up & subscription process is made off-line by Bizao team which will be available through self-service in a future version of Bizao API (already on roadmap).

After subscription, the Bizao team will give you an ACCESS_TOKENto use as Header in all calls you will make to the API:

  • Sample of ACCESS_TOKEN
    4qa1bae4-3f9b-346-9w1b-c0e4d4ef

The B2B connection to Bizao platform is made in SSL1 way to secure your traffic.

Bizao API offers three methods of end-user authentication:

  1. One time Password : this is an explicit web authentication mode. It is adapted for all HTTP access. It only needs a mobile to receive a PIN code by SMS.
  2. 3G-Redirect URL : this is a mobile-only implicit mode. It works only for MNOs’ customers connected through their 3G data network. The results of a successful authentication is sent to a callback URL provided by your app.
  3. MO SMS with ShortCode : this is an implicit authentication mode. It begins the authentication process by sending your users an SMS with a short code, then sends the result by a callback URL provided by your app.

The descriptions and uses of these methods are in dedicated sections within this document. During the authentication journey, the Bizao platform will generate/provide you with a pair of keys as credentials for each Client authenticated:

  • bizao-token: it’s an unique and limited time ID ( 1 year ) to use for critical API calls such as payment API)
    • Sample of token :
      "B64ZNgw9MaNekCsFRYf9pe6WZFzYnOKQxoyUagq8v2anGGrY4JG+Xx5MO42iFpkEYzf|MCO=OCI|tcd=1526548445|ted=1526348545|uSmSX85ScNIIMK5QHOK1kSoNYYk=”

      Note:

      The parameter ‘tcd’ stands for Token Creation Date (timestamp format)

  • bizao-alias: it’s a unique and unlimited in time ID to use for tracking user or in SMS-API
    • Sample of alias :
      “PDKSUB-200-dM50oiCPDlihWwXlf9rNGegZeQjC8eX/EvF8e/BJAyg=”

Note:

These Keys/IDs are and must be used instead of user’s MSISDN for all API-Call you will made on Bizao platform

Was this article helpful to you? Yes 2 No

How can we help?