Bill Query (Data Bundle)
base_url: http://sandbox.etranzactng.com/SBP
Description: The information received during this call is crucial to the Bill Payment leg. The plan ID
gotten from this query will be the corresponding productid to be used for Bill(Bundle) Payment. Always verify that the AMOUNT & PLAN ID
are in tune with the desired plan.
MTN
This Telco has plans that reiterate planIDs.
The KEY DIFFERENCE is in the amount.
AIRTEL
This Telco sends planIDs in a numbered format. These numbers are to be sent as received in the productid field during Bill (Bundle) Payment.
ETISALAT
This Telco doesn’t send planIDs but all prices for all Data Bundles are unique.
GLO
This Telco sends planIDs in the following
format: DATA-17.
- Sample Request
- Sample Response
curl `${base_url}/bill-query`
-H "Content-type: application/json"
-X POST
-d '{
"clientRef": "TestBillPay051",
"billId": 34,
"customerId": "09039639237"
}'
This endpoint confirms the validity of customer’s details and in the case of Data Bundle, brings out all plans available under specified Telco.
Bill-query (Data Bundle) response parameters (Plan Payload)
Parameter | Description |
---|---|
planId | This is the ID used to identify the Data Plan required |
planName | This is the corresponding plan name (Usually contains Amount of Data) |
planPrice | This contains the price of the Data Bundle |
planCode | This contains the corresponding plan code (Usually null) |
planSize | This contains the corresponding plan size (Usually Null) |
planValidity | This contains the duration of validity for the plan |
{
"status": true,
"message": "Bill Query performed.",
"result": {
"clientRef": "TestBillPay051",
"paymentRef": "09FG210329075315955FCMGVL",
"customerId": "09039639237",
"terminalId": "7000000001",
"mobile": null,
"billId": 34,
"billName": "MTN Data Bundle",
"billerCode": "mtn",
"customerName": null,
"status": "SUCCESS",
"error": null,
"plans": [
{
"planId": "9",
"planName": "20MB",
"planPrice": "25",
"planCode": null,
"planSize": null,
"planValidity": " 1 Day"
},
{
"planId": "9",
"planName": "50MB",
"planPrice": "50",
"planCode": null,
"planSize": null,
"planValidity": " 7 Days"
},
{
"planId": "9",
"planName": "100MB",
"planPrice": "100",
"planCode": null,
"planSize": null,
"planValidity": "24 Hours"
},
{
"planId": "9",
"planName": "160MB",
"planPrice": "150",
"planCode": null,
"planSize": null,
"planValidity": " 30 Days"
},
{
"planId": "9",
"planName": "200MB",
"planPrice": "200",
"planCode": null,
"planSize": null,
"planValidity": "2 Days"
},
{
"planId": "9",
"planName": "350MB",
"planPrice": "300",
"planCode": null,
"planSize": null,
"planValidity": "7 Days"
},
{
"planId": "24",
"planName": "Xtratalk 300",
"planPrice": "300",
"planCode": null,
"planSize": null,
"planValidity": "7 Days"
},
{
"planId": "25",
"planName": "Xtradata 300",
"planPrice": "300",
"planCode": null,
"planSize": null,
"planValidity": "7 Days"
},
{
"planId": "18",
"planName": "1GB",
"planPrice": "300",
"planCode": null,
"planSize": null,
"planValidity": " 24 Hours"
},
{
"planId": "9",
"planName": "750MB",
"planPrice": "500",
"planCode": null,
"planSize": null,
"planValidity": "14 Days"
},
{
"planId": "20",
"planName": "2.5GB",
"planPrice": "500",
"planCode": null,
"planSize": null,
"planValidity": "48 Hours"
},
{
"planId": "19",
"planName": "1GB",
"planPrice": "500",
"planCode": null,
"planSize": null,
"planValidity": "7 Days"
},
{
"planId": "24",
"planName": "Xtratalk 500",
"planPrice": "500",
"planCode": null,
"planSize": null,
"planValidity": "7 Days"
},
{
"planId": "25",
"planName": "Xtradata 500",
"planPrice": "500",
"planCode": null,
"planSize": null,
"planValidity": "7 Days"
},
{
"planId": "9",
"planName": "1.5GB",
"planPrice": "1000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "24",
"planName": "Xtratalk 1000",
"planPrice": "1000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "25",
"planName": "Xtradata 1000",
"planPrice": "1000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "9",
"planName": "2GB",
"planPrice": "1200",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "36",
"planName": "3GB",
"planPrice": "1500",
"planCode": null,
"planSize": null,
"planValidity": " 30 Days"
},
{
"planId": "9",
"planName": "6GB",
"planPrice": "1500",
"planCode": null,
"planSize": null,
"planValidity": "7 Days"
},
{
"planId": "9",
"planName": "4.5GB",
"planPrice": "2000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "24",
"planName": "Xtratalk 2000",
"planPrice": "2000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "25",
"planName": "Xtradata 2000",
"planPrice": "2000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "9",
"planName": "6GB",
"planPrice": "2500",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "9",
"planName": "10GB",
"planPrice": "3000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "9",
"planName": "12GB",
"planPrice": "3500",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "9",
"planName": "20GB",
"planPrice": "5000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "24",
"planName": "Xtratalk 5000",
"planPrice": "5000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "25",
"planName": "Xtradata 5000",
"planPrice": "5000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "36",
"planName": "25GB",
"planPrice": "6000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "9",
"planName": "30GB",
"planPrice": "8000",
"planCode": null,
"planSize": null,
"planValidity": "60 Days"
},
{
"planId": "9",
"planName": "40GB",
"planPrice": "10000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "24",
"planName": "Xtratalk 10000",
"planPrice": "10000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "25",
"planName": "Xtradata 10000",
"planPrice": "10000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "9",
"planName": "75GB",
"planPrice": "15000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "24",
"planName": "Xtratalk 15000",
"planPrice": "15000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "25",
"planName": "Xtradata 15000",
"planPrice": "15000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "12",
"planName": "30GB",
"planPrice": "13500",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "36",
"planName": "110GB",
"planPrice": "20000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "24",
"planName": "Xtratalk 20000",
"planPrice": "20000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "25",
"planName": "Xtradata 20000",
"planPrice": "20000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "9",
"planName": "75GB",
"planPrice": "20000",
"planCode": null,
"planSize": null,
"planValidity": "60 Days"
},
{
"planId": "9",
"planName": "120GB",
"planPrice": "30000",
"planCode": null,
"planSize": null,
"planValidity": "60 Days"
},
{
"planId": "12",
"planName": "90GB",
"planPrice": "40000",
"planCode": null,
"planSize": null,
"planValidity": "30 Days"
},
{
"planId": "9",
"planName": "150GB",
"planPrice": "50000",
"planCode": null,
"planSize": null,
"planValidity": "90 Days"
},
{
"planId": "12",
"planName": "150GB",
"planPrice": "50000",
"planCode": null,
"planSize": null,
"planValidity": "90 Days"
},
{
"planId": "9",
"planName": "250GB",
"planPrice": "75000",
"planCode": null,
"planSize": null,
"planValidity": "90 Days"
},
{
"planId": "9",
"planName": "1TB",
"planPrice": "100000",
"planCode": null,
"planSize": null,
"planValidity": "365 Days"
},
{
"planId": "9",
"planName": "400GB",
"planPrice": "120000",
"planCode": null,
"planSize": null,
"planValidity": "365 Days"
},
{
"planId": "9",
"planName": "1000GB",
"planPrice": "250000",
"planCode": null,
"planSize": null,
"planValidity": "365 Days"
},
{
"planId": "9",
"planName": "2000GB",
"planPrice": "450000",
"planCode": null,
"planSize": null,
"planValidity": "365 Days"
}
]
}
}