Buying Services through the VTpass API

This section contains the recommended flow for purchasing a service on VTpass RESTful API.

Authentication

The VTpass API uses Basic Authentication.

It should be passed as a concatenated string like this

username:password

Please use the following details for authentication

Username: YourVtpassEmail

Password: YourPassword

Please create your authentication details by following the instructions here.

Request ID Format

The Request ID should be a string in the unix format YYYYMMDDHHII consisting of today’s date + current hour and minute (e.g: 202201301610) and can be concatenated with any other alphanumeric string as desired (e.g: 202201301610ad8ef08acd8fc0f or 2022013016104738492849).

Note:

  • MUST BE 12 CHARACTERS OR MORE
  • FIRST 12 CHARACTERS MUST BE NUMERIC
  • FIRST 12 CHARACTERS MUST COMPRISE OF TODAY’S DATE
  • Date and Time should be in Africa/Lagos Timezone or GMT +1

 

Example
    "request_id" => "202202071830YUs83meikd"

 

How To Buy Airtime

 

How To Buy Products With Variations