Skip to main content
The base urls for staging and production are as follows:
EnvironmentBase Url
Staginghttps://api.staging.pipevest.com/v1
Productionhttps://api.pipevest.com/v1
Only the authentication endpoints leverage these urls directly. The rest of the endpoints require the USSD base url.

​
USSD Base Url

After authenticating and receiving an access token, requests to the USSD api can be made at the given urls:
EnvironmentBase Url
Staginghttps://api.staging.pipevest.com/v1/ussd
Productionhttps://api.pipevest.com/v1/ussd

​
Using Authenticated Endpoints

All API endpoints are authenticated using OAuth 2.0 standards. A clientId and clientSecret must be exchanged for a shortlived access token. This access token is then used to authenticate further requests.
1

Access Token Request

  curl --request POST \
    --url https://api.staging.pipevest.com/v1/oauth/token \
    ...
    --data 'clientId=<client-id>'
    --data 'clientSecret=<client-secret>'
2

Authenticate Requests with Token

The access token is passed into the authorization header as a bearer token
  curl --request GET \
    --url https://api.staging.pipevest.com/v1/ussd/process \
    --header 'Authorization: Bearer <access-token>' \
    --header 'x-client-id: <client-id>' \
    ...
    --data 'sessionId=<session-id>'
    --data 'choice=1'

Authentication Concepts

Check out the auth mechanisms used to keep the API secure

Authentication Guide

Understand how to create and revoke auth tokens