Data

Web-hooks for Data transactions

Sample request for vending data

{
  "plan_code": "1001",
  "phonenumber": "08169643167",
  "transaction_id": "80kld-E-82269942-209322"
}

Vending Data Operation

POST {{baseUrl}}/service/api/single_data_direct_vending

Path Parameters

Name	Type	Description
x-api-key*	String	The API key is a unique key that must be passed to the header before any request and can be found in the dashboard.
client-id*	String	This is a unique id for customers which can also be found in the dashboard when login

Request Body

Name	Type	Description
plan_code*	String	Each network has its plan code. The code of the network you are vending is required here
phonenumber*	String	This is the phone number of the customer
transaction_id*	String	This is the Unique Id you provided for the transaction.

200: OK Successful

Sample response

{
    "status_code": "200",
    "transaction_id": null,
    "reference": "80kjd-D-82269942-218322",
    "phonenumber": "08069633127",
    "network": "MTN",
    "message": "Successful"
}

300: Multiple Choices Duplicate

Sample response

{
    "status_code": "300",
    "transaction_id": null,
    "reference": "80kjd-D-82269942-218322",
    "phonenumber": "08069633127",
    "network": "MTN",
    "message": "Duplicate customer reference"
}

100: Continue others

Sample response

{
    "status_code": "100",
    "message": Any other error
}

404: Not Found notFound

Sample response

{
    "status_code": "3",
    "message": "not found"
}

500: Internal Server Error failedStatus

Sample response

{
    "status_code": "500",
    "transaction_id": "166272313399778110",
    "reference": "80kjd-612269142-test-n21",
    "phonenumber": "08169653167",
    "network": "MTN",
    "message": "unsuccessful"
}

501: Pending Transaction

Sample Response
{
    "status_code": "501",
    "message": "Pending"
}

200

{
  "id": 1,
  "name": "John",
  "age": 30
}

400

{
  "error": "Invalid request"
}

Get all the data packages for different network

POST {{baseUrl}}/service/api/get-packages

The endpoint is used to get all data packages available for a network send as request. It return a json format response. If no network is not provided, a response with status code 1 will be returned.

Headers

Name	Type	Description
x-api-key*	String
client-id*	String

Request Body

Name	Type	Description
network*	String	The network you want to get

Sample request for getting packages

{
    "network": "MTN"
}

200: OK Successful

Sample response

{
    "status_code": "0",
    "message": "Successful",
    "result": [
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "100MB ",
            "bundle_validity": " Daily Plan",
            "bundle_description": " Daily Plan",
            "bundle_price": "100",
            "plan_code": "1001"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "200MB",
            "bundle_validity": " 2-day Plan",
            "bundle_description": " 2-day Plan",
            "bundle_price": "200",
            "plan_code": "1002"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "350MB",
            "bundle_validity": " Weekly Plan",
            "bundle_description": " Weekly Plan",
            "bundle_price": "300",
            "plan_code": "1003"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "750MB",
            "bundle_validity": " 2-Week plan",
            "bundle_description": " 2-Week plan",
            "bundle_price": "500",
            "plan_code": "1004"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "2GB",
            "bundle_validity": " Monthly Plan",
            "bundle_description": " Monthly Plan",
            "bundle_price": "1200",
            "plan_code": "1005"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "1.5GB",
            "bundle_validity": " 1-Month Mobile Plan",
            "bundle_description": " 1-Month Mobile Plan",
            "bundle_price": "1000",
            "plan_code": "1006"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "750MB",
            "bundle_validity": " Weekly Plan ",
            "bundle_description": " Weekly Plan ",
            "bundle_price": "500",
            "plan_code": "1007"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "3GB",
            "bundle_validity": " 3GB Monthly Plan",
            "bundle_description": " 3GB Monthly Plan",
            "bundle_price": "1500",
            "plan_code": "1011"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "325GB",
            "bundle_validity": " 6_Months Plan",
            "bundle_description": " 6_Months Plan",
            "bundle_price": "100000",
            "plan_code": "1012"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "1000GB",
            "bundle_validity": " 1_Year Plan ",
            "bundle_description": " 1_Year Plan ",
            "bundle_price": "300000",
            "plan_code": "1013"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "1500GB",
            "bundle_validity": " 1_Year Plan ",
            "bundle_description": " 1_Year Plan ",
            "bundle_price": "450000",
            "plan_code": "1014"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "2.5GB ",
            "bundle_validity": " 2_Day Plan",
            "bundle_description": " 2_Day Plan",
            "bundle_price": "500",
            "plan_code": "1015"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "400GB",
            "bundle_validity": " Yearly Plan",
            "bundle_description": " Yearly Plan",
            "bundle_price": "120000",
            "plan_code": "1016"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "75GB ",
            "bundle_validity": " 2_Month Plan",
            "bundle_description": " 2_Month Plan",
            "bundle_price": "20000",
            "plan_code": "1017"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "120GB",
            "bundle_validity": " 2_Month Plan",
            "bundle_description": " 2_Month Plan",
            "bundle_price": "30000",
            "plan_code": "1018"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "150GB",
            "bundle_validity": " 3_Month Plan",
            "bundle_description": " 3_Month Plan",
            "bundle_price": "50000",
            "plan_code": "1019"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "250GB",
            "bundle_validity": " 3_Month Plan",
            "bundle_description": " 3_Month Plan",
            "bundle_price": "75000",
            "plan_code": "1020"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "25GB",
            "bundle_validity": " Monthly Plan",
            "bundle_description": " Monthly Plan",
            "bundle_price": "6000",
            "plan_code": "1021"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "1GB ",
            "bundle_validity": " Weekly Plan",
            "bundle_description": " Weekly Plan",
            "bundle_price": "500",
            "plan_code": "1022"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "6GB",
            "bundle_validity": " Weekly Plan",
            "bundle_description": " Weekly Plan",
            "bundle_price": "1500",
            "plan_code": "1023"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "6GB",
            "bundle_validity": " Monthly Plan",
            "bundle_description": " Monthly Plan",
            "bundle_price": "2500",
            "plan_code": "1024"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "10GB",
            "bundle_validity": " Monthly Plan",
            "bundle_description": " Monthly Plan",
            "bundle_price": "3000",
            "plan_code": "1025"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "110GB",
            "bundle_validity": " Monthly Plan",
            "bundle_description": " Monthly Plan",
            "bundle_price": "20000",
            "plan_code": "1026"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "30GB",
            "bundle_validity": " SME Share Bundle",
            "bundle_description": " SME Share Bundle",
            "bundle_price": "13500",
            "plan_code": "1027"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "90GB",
            "bundle_validity": " SME Share Bundle",
            "bundle_description": " SME Share Bundle",
            "bundle_price": "40000",
            "plan_code": "1028"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "4.5GB",
            "bundle_validity": " 1 Month all day plan",
            "bundle_description": " 1 Month all day plan",
            "bundle_price": "2000",
            "plan_code": "1029"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "12GB",
            "bundle_validity": " Month Plan",
            "bundle_description": " Month Plan",
            "bundle_price": "3500",
            "plan_code": "1030"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "20GB",
            "bundle_validity": " Month Plan",
            "bundle_description": " Month Plan",
            "bundle_price": "5000",
            "plan_code": "1031"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "40GB",
            "bundle_validity": " Month Plan",
            "bundle_description": " Month Plan",
            "bundle_price": "10000",
            "plan_code": "1032"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "75GB",
            "bundle_validity": " Month Plan",
            "bundle_description": " Month Plan",
            "bundle_price": "15000",
            "plan_code": "1033"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "75MB",
            "bundle_validity": " Daily Plan",
            "bundle_description": " Daily Plan",
            "bundle_price": "100",
            "plan_code": "1060"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "200MB",
            "bundle_validity": "2 days",
            "bundle_description": "2 days",
            "bundle_price": "200",
            "plan_code": "1061"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XT300",
            "bundle_validity": "XT 300Weekly",
            "bundle_description": "XT 300Weekly",
            "bundle_price": "300",
            "plan_code": "1062"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XD300",
            "bundle_validity": "XT 300Weekly",
            "bundle_description": "XT 300Weekly",
            "bundle_price": "300",
            "plan_code": "1063"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "350MB",
            "bundle_validity": "7 Days",
            "bundle_description": "7 Days",
            "bundle_price": "300",
            "plan_code": "1064"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "2.5GB",
            "bundle_validity": "2 Days",
            "bundle_description": "2 Days",
            "bundle_price": "500",
            "plan_code": "1065"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "750MB",
            "bundle_validity": "14 Days",
            "bundle_description": "14 Days",
            "bundle_price": "500",
            "plan_code": "1066"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XT500",
            "bundle_validity": "XT 500Weekly",
            "bundle_description": "XT 500Weekly",
            "bundle_price": "500",
            "plan_code": "1067"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "750MB",
            "bundle_validity": "7 Days",
            "bundle_description": "7 Days",
            "bundle_price": "500",
            "plan_code": "1068"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "2GB",
            "bundle_validity": "2 Days",
            "bundle_description": "2 Days",
            "bundle_price": "500",
            "plan_code": "1069"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XD500",
            "bundle_validity": "XD 500Weekly",
            "bundle_description": "XD 500Weekly",
            "bundle_price": "500",
            "plan_code": "1070"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "2GB",
            "bundle_validity": "2 Days",
            "bundle_description": "2 Days",
            "bundle_price": "500",
            "plan_code": "1071"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XD1000",
            "bundle_validity": "2 Days",
            "bundle_description": "2 Days",
            "bundle_price": "1000",
            "plan_code": "1072"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "1.5GB",
            "bundle_validity": "30 Days",
            "bundle_description": "30 Days",
            "bundle_price": "1000",
            "plan_code": "1073"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XT1000Mthly",
            "bundle_validity": "XT 1000Monthly",
            "bundle_description": "XT 1000Monthly",
            "bundle_price": "1000",
            "plan_code": "1074"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "2GB",
            "bundle_validity": "30 Days",
            "bundle_description": "30 Days",
            "bundle_price": "1200",
            "plan_code": "1075"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "6GB",
            "bundle_validity": "7 Days",
            "bundle_description": "7 Days",
            "bundle_price": "1200",
            "plan_code": "1076"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "3GB",
            "bundle_validity": "30 Days",
            "bundle_description": "30 Days",
            "bundle_price": "1200",
            "plan_code": "1077"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XT2000",
            "bundle_validity": "XT 2000Monthly",
            "bundle_description": "XT 2000Monthly",
            "bundle_price": "2000",
            "plan_code": "1078"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "4.5GB",
            "bundle_validity": "30 Days",
            "bundle_description": "30 Days",
            "bundle_price": "2000",
            "plan_code": "1079"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XD2000",
            "bundle_validity": "XD 2000Monthly",
            "bundle_description": "XD 2000Monthly",
            "bundle_price": "2000",
            "plan_code": "1080"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "6GB",
            "bundle_validity": "30 Days",
            "bundle_description": "30 Days",
            "bundle_price": "2500",
            "plan_code": "1081"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "10GB",
            "bundle_validity": "30 Days",
            "bundle_description": "30 Days",
            "bundle_price": "3000",
            "plan_code": "1082"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XD5000",
            "bundle_validity": "XD 5000Monthly",
            "bundle_description": "XD 5000Monthly",
            "bundle_price": "5000",
            "plan_code": "1083"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XT5000",
            "bundle_validity": "XT 5000Monthly",
            "bundle_description": "XT 5000Monthly",
            "bundle_price": "5000",
            "plan_code": "1084"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "20GB",
            "bundle_validity": "30 Days",
            "bundle_description": "30 Days",
            "bundle_price": "5000",
            "plan_code": "1085"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "25GB",
            "bundle_validity": "30 Days",
            "bundle_description": "30 Days",
            "bundle_price": "5000",
            "plan_code": "1086"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "30GB",
            "bundle_validity": "60 Days",
            "bundle_description": "60 Days",
            "bundle_price": "8000",
            "plan_code": "1087"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XD10000",
            "bundle_validity": "XD10000 Monthly",
            "bundle_description": "XD10000 Monthly",
            "bundle_price": "10000",
            "plan_code": "1089"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "40GB",
            "bundle_validity": "30 Days",
            "bundle_description": "30 Days",
            "bundle_price": "10000",
            "plan_code": "1090"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XT10000",
            "bundle_validity": "XT 10000Monthly",
            "bundle_description": "XT 10000Monthly",
            "bundle_price": "10000",
            "plan_code": "1091"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "35GB",
            "bundle_validity": "SME",
            "bundle_description": "SME",
            "bundle_price": "13500",
            "plan_code": "1092"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XT15000",
            "bundle_validity": "XT 10000Monthly",
            "bundle_description": "XT 10000Monthly",
            "bundle_price": "15000",
            "plan_code": "1093"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XD15000",
            "bundle_validity": "XD 15000Monthly",
            "bundle_description": "XD 15000Monthly",
            "bundle_price": "15000",
            "plan_code": "1094"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "75GB",
            "bundle_validity": "30 Days",
            "bundle_description": "30 Days",
            "bundle_price": "15000",
            "plan_code": "1095"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XD15000",
            "bundle_validity": "XD 15000Monthly",
            "bundle_description": "XD 15000Monthly",
            "bundle_price": "15000",
            "plan_code": "1096"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XT20000",
            "bundle_validity": "XT 20000Monthly",
            "bundle_description": "XT 20000Monthly",
            "bundle_price": "20000",
            "plan_code": "1097"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "75GB",
            "bundle_validity": "60 Days",
            "bundle_description": "60 Days",
            "bundle_price": "20000",
            "plan_code": "1098"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "110GB",
            "bundle_validity": "30 Days",
            "bundle_description": "30 Days",
            "bundle_price": "20000",
            "plan_code": "1099"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "XD20000",
            "bundle_validity": "XD 20000Monthly",
            "bundle_description": "XD 20000Monthly",
            "bundle_price": "20000",
            "plan_code": "1100"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "120GB",
            "bundle_validity": "60 Days",
            "bundle_description": "60 Days",
            "bundle_price": "30000",
            "plan_code": "1101"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "90GB",
            "bundle_validity": "SME",
            "bundle_description": "SME",
            "bundle_price": "40000",
            "plan_code": "1102"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "150GB",
            "bundle_validity": "SME 90days",
            "bundle_description": "SME 90days",
            "bundle_price": "50000",
            "plan_code": "1103"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "150GB",
            "bundle_validity": "90 days",
            "bundle_description": "90 days",
            "bundle_price": "50000",
            "plan_code": "1104"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "250GB",
            "bundle_validity": "90 days",
            "bundle_description": "90 days",
            "bundle_price": "75000",
            "plan_code": "1105"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "1TB",
            "bundle_validity": "365 days",
            "bundle_description": "365 days",
            "bundle_price": "100000",
            "plan_code": "1106"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "325GB",
            "bundle_validity": "180 days",
            "bundle_description": "180 days",
            "bundle_price": "100000",
            "plan_code": "1107"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "400GB",
            "bundle_validity": "365 days",
            "bundle_description": "365 days",
            "bundle_price": "120000",
            "plan_code": "1108"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "1000GB",
            "bundle_validity": "365 days",
            "bundle_description": "365 days",
            "bundle_price": "300000",
            "plan_code": "1109"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "2000GB",
            "bundle_validity": "365 days",
            "bundle_description": "365 days",
            "bundle_price": "450000",
            "plan_code": "1110"
        },
        {
            "plan_name": "MTN data_plan",
            "bundle_value": "1500GB",
            "bundle_validity": "365 days",
            "bundle_description": "365 days",
            "bundle_price": "450000",
            "plan_code": "1111"
        }
    ]
}

404: Not Found Network not found with status code 1

{
    "status_code": "1",
    "message": "Network no valid",
    "result": null
}