Buying Services through the VTpass API

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

Authentication

Learn about authentication from 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

• Get service categories. learn more
• Get Service ID. learn more
• Purchase products.
  • • a. MTN airtime
    • b. GLO airtime
    • c. Airtel airtime
    • d. 9mobile airtime

How To Buy Products With Variations

• Get service categories. learn more
• Get service ID. learn more
• Get variation codes. learn more
• Purchase product.
  • • a. MTN data
    • b. Airtel data
    • c. GLO data
    • d. 9mobile data
    • f. Smile Network Payment API
    • g. DSTV subscription payment API
    • h. GOTV subscription payment API
    • i. Startimes subscription API
    • j. Ikeja electricity distribution company (IKEDC) payment API
    • k. Eko electricity distribution company (EKEDC) payment API
    • l. Kano electricity distribution company (KEDCO) payment API
    • m. Portharcourt electricity distribution company (PHED) payment API
    • n. Jos electricity distribution company (JED) payment API
    • o. Ibadan electricity distribution company (IBEDC) payment API
    • p. Kaduna electricity distribution company (KAEDCO) payment API
    • q. Third party insurance API