Product Price List

Some product items have sub-items OR a price list that describes the available items for purchase. This section describes how a product's price list can be obtained.

Get Price List

To retrieve the price list, pass the main product code as a query parameter.

GET https://sandbox.ellypayapp.com/merchant/products/price-list?product_code={code}

This section applies to products returned from the list above whose value for has_price_list is a boolean true.

Request

Query Parameters

Parameter	Type	Description	Required
product_code	string	The code of the main product (whose price list is required) as obtained from the list above	YES

Response

Response Body

Parameter	Type	Description
code	string	The unique code of the price list item
name	string	The name of the price list item
price	float	The cost of the item

Sample Response (OK)

// using the product_code as DSTV
// https://api.ellypayapp.com/merchant/products/price-list?product_code=DSTV

{
    "code": 200,
    "status": "success",
    "message": "Request completed successfully.",
    "data": {
        "price_list": [
            {
                "code": "DSTV:21552",
                "name": "DStv Access at UGX 35,000",
                "price": 35000
            },
            {
                "code": "DSTV:21551",
                "name": "DStv Family at UGX 52,000",
                "price": 52000
            },
            {
                "code": "DSTV:21550",
                "name": "DStv Compact at UGX 84,000",
                "price": 84000
            },
            {
                "code": "DSTV:21549",
                "name": "DStv Compact Plus at UGX 135,000",
                "price": 135000
            },
            {
                "code": "DSTV:21548",
                "name": "DStv Premium at UGX 227,000",
                "price": 227000
            },
            {
                "code": "DSTV:21553",
                "name": "DStv Asia at UGX 128,000",
                "price": 128000
            },
            {
                "code": "DSTV:215649",
                "name": "DStv French 11 at UGX 66,375",
                "price": 66375
            },
            {
                "code": "DSTV:215650",
                "name": "DStv French Plus at UGX 132,750",
                "price": 132750
            },
            {
                "code": "DSTV:215462",
                "name": "DStv HDPVR Access Service at UGX 42,000",
                "price": 42000
            },
            {
                "code": "DSTV:215648",
                "name": "DStv Mobile Compact Value at UGX 15,000",
                "price": 15000
            },
            {
                "code": "DSTV:215460",
                "name": "DStv Premium + ASIA at UGX 237,000",
                "price": 237000
            },
            {
                "code": "DSTV:215459",
                "name": "DStv Premium with Dual View at UGX 328,500",
                "price": 328500
            },
            {
                "code": "DSTV:215646",
                "name": "DStv Premium + French Bonus at UGX 349,000",
                "price": 349000
            },
            {
                "code": "DSTV:215615",
                "name": "DStv Mobile Compact Standalone at UGX 15,000",
                "price": 15000
            }
        ]
    }
}

Sample Response (Error)

{
    "code": 400,
    "status": "error",
    "message": "Missing Parameter 'product_code'",
    "data": {}
}

We strongly advise that price list items are not stored in a database but always queried from the API. In the event you opt to store them in the local database, ensure that your refresh regularly.