9mobile SME Data Subscription API

This section contains the recommended flow for integrating 9mobile SME Data Subscription services on the VTpass RESTful API.

Authentication

Learn about authentication from here.

Available Endpoints

To integrate the VTpass 9mobile SME Data Subscription Payment RESTful API, the endpoints below applies:

  • Get Variation Codes: this returns variation codes for various 9mobile SME Data (subscription plans)
  • Purchase Product (Using the variation code gotten in the first step)
  • Query transaction status

 

GET VARIATION CODES

Using a GET method, the VTpass variation codes for 9mobile SME Data subscription plans can be accessed with the endpoint below:

Live:   https://vtpass.com/api/service-variations?serviceID=9mobile-sme-data

Sandbox: https://sandbox.vtpass.com/api/service-variations?serviceID=9mobile-sme-data

FIELDS Mandatory/Optional TYPE DESCRIPTION
N/A N/A N/A N/A

 

 

EXPECTED RESPONSE

{
   "response_description":"000",
   "content":{
      "ServiceName":"9mobile SME Data",
      "serviceID":"9mobile-sme-data",
      "convinience_fee":"0 %",
      "varations":[
         {
            "variation_code":"eti-sme-100",
            "name":"9mobile Sme Data - 100 Naira - 100MB - 1 day",
            "variation_amount":"100.00",
            "fixedPrice":"Yes"
         },
         {
            "variation_code":"eti-sme-200",
            "name":"9mobile Sme Data - 200 Naira -650MB - 2 day",
            "variation_amount":"200.00",
            "fixedPrice":"Yes"
         },
         {
            "variation_code":"eti-sme-500",
            "name":"9mobile Sme Data - 500 Naira - 500MB - 30 Days",
            "variation_amount":"500.00",
            "fixedPrice":"Yes"
          },
          ...
      ]
   }
}

PURCHASE PRODUCT

Using a POST method, 9mobile SME Data bundle can be purchased with the endpoint below:  

Live: https://vtpass.com/api/pay

Sandbox: https://sandbox.vtpass.com/api/pay

ServiceID: 9mobile-sme-data

On sandbox, use test phone number: 08011111111.

To simulate a failed transaction on sandbox, please use any number apart from the one provided above as the phone number.  

FIELDS Mandatory/Optional TYPE DESCRIPTION
request_id M String This is a unique reference with which you can use to identify and query the status of a given transaction after the transaction has been executed. Click here to understand how to generate a valid request ID
serviceID M String Service ID as specified by VTpass. In this case, it is 9mobile-sme-data
billersCode M String The phone number you wish to make the Subscription payment on
variation_code M String The code of the variation (as specified in the GET VARIATIONS method as variation_code).
amount O Number The amount of the variation (as specified in the GET VARIATIONS endpoint as variation_amount) This amount will be ignored as the variation code determine the price of the data bundle.
phone M Number The phone number of the customer or recipient of this service

 

EXPECTED RESPONSE

{
  "code": "000",
  "content": {
      "transactions": {
         "status": "delivered",
         "product_name": "9mobile SME Data",
         "unique_element": "08011111111",
         "unit_price": 100,
         "quantity": 1,
         "service_verification": null,
         "channel": "api",
         "commission": 4,
         "total_amount": 96,
         "discount": null,
         "type": "Data Services",
         "email": "sandbox@vtpass.com",
         "phone": "07061933309",
         "name": null,
         "convinience_fee": 0,
         "amount": 100,
         "platform": "api",
         "method": "api",
         "transactionId": "1582290782154"
       }
    },
    "response_description": "TRANSACTION SUCCESSFUL",
    "requestId": "202403141009_j923d;lkre7yvmhgfdszxvbhjuytdxcfgvhkj",
    "amount": "100.00",
    "transaction_date": {
        "date": "2024-03-14 14:13:02.000000",
        "timezone_type": 3,
        "timezone": "Africa/Lagos"
     },
     "purchased_code": ""
}

QUERY TRANSACTION STATUS

Using a POST method, transaction status can be queried with the endpoint below:

Live: https://vtpass.com/api/requery

Sandbox: https://sandbox.vtpass.com/api/requery

FIELDS Mandatory/Optional TYPE DESCRIPTION
request_id M String
This is the reference with which you sent when purchasing a transaction after the transaction has been executed.

 

EXPECTED RESPONSE

{
  "code": "000",
  "content": {
      "transactions": {
         "status": "delivered",
         "product_name": "9mobile SME Data",
         "unique_element": "08011111111",
         "unit_price": 100,
         "quantity": 1,
         "service_verification": null,
         "channel": "api",
         "commission": 4,
         "total_amount": 96,
         "discount": null,
         "type": "Data Services",
         "email": "sandbox@vtpass.com",
         "phone": "07061933309",
         "name": null,
         "convinience_fee": 0,
         "amount": 100,
         "platform": "api",
         "method": "api",
         "transactionId": "1582290782154"
       }
    },
    "response_description": "TRANSACTION SUCCESSFUL",
    "requestId": "202403141009_j923d;lkre7yvmhgfdszxvbhjuytdxcfgvhkj",
    "amount": "100.00",
    "transaction_date": {
        "date": "2024-03-14 14:13:02.000000",
        "timezone_type": 3,
        "timezone": "Africa/Lagos"
     },
     "purchased_code": ""
}

You can check out the complete list of RESPONSE CODES HERE.