Get Services & Categories

Get all services, for each category for a given Storefront domain

In order to get available services and categories using Centili Storefront Content API v1, you need to send an HTTP GET request with a domain name.

Before initiating a get services request you will need to obtain an access token

GET Services & Categories request

URL to which a request should be sent

https://capi.centili.com/content/v1/services
https://capi.centili.com/content/v1/services?domain={domain}
Host: capi.centili.com:443
Authorization: bearer token

Request parameters

ParameterDescriptionExampleRequired as
domainA Storefront domain name for which the services and categories are retrievedstore-demo.centili.com mandatory

GET Services & Categories response

πŸ‘

200

Obtained service categories for a domain

Response example

[
    {
        "categoryName": "Gaming",
        "services": [
            {
                "image": "https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/388e8ff1fd2db5c2c644562e697fd0f1.png?v=77",
                "name": "Fortnite",
                "merchant": "Demo Storefront",
                "description": "Fortnite is a survival game where 100 players fight against each other in player versus player combat to be the last one standing. It is a fast-paced, action-packed game, not unlike The Hunger Games, where strategic thinking is a must in order to survive.",
                "serviceKey": "388e8ff1fd2db5c2c644562e697fd0f1"
            },
            {
                "image": "https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/e259a3f09b93d32d494b394ba9a9eb7e.png?v=77",
                "name": "Mobile Legends",
                "merchant": "Demo Storefront",
                "description": "Gameplay. Mobile Legends: Bang Bang is a multiplayer online battle arena (MOBA) game designed for mobile phones. The game is free-to-play and is only monetized through in-game purchases like characters and skins. Each player can control a selectable character, called β€œHero”, with unique abilities and traits.",
                "serviceKey": "e259a3f09b93d32d494b394ba9a9eb7e"
            },
            {
                "image": "https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/3fcc8b7821f547ac2774b1a6c12616de.png?v=77",
                "name": "Playstation",
                "merchant": "Demo Storefront",
                "description": "Explore PlayStation Store from your console, smartphone or web browser and discover a treasure trove of games β€” from triple-A blockbusters to indie gems β€” as well as add-ons and season passes. With regular sales, promotions and extra savings for PlayStation Plus members, there's always one more adventure waiting.",
                "serviceKey": "3fcc8b7821f547ac2774b1a6c12616de"
            },
            {
                "image": "https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/cb976e00afbd109eaf5b4b77c72eb8fb.png?v=77",
                "name": "PubG",
                "merchant": "Demo Storefront",
                "description": "Gameplay. PUBG is a player versus player shooter game in which up to one hundred players fight in a battle royale, a type of large-scale last man standing deathmatch where players fight to remain the last alive. Players can choose to enter the match solo, duo, or with a small team of up to four people.",
                "serviceKey": "cb976e00afbd109eaf5b4b77c72eb8fb"
            },
            {
                "image": "https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/a015bd48b95345cba6ee4ba8e84d7256.png?v=77",
                "name": "XBox ",
                "merchant": "Demo Storefront",
                "description": "Xbox Live is an online multiplayer gaming and digital media delivery service created and operated by Microsoft. The service is used by the Xbox system as well as mobile and PC devices.",
                "serviceKey": "a015bd48b95345cba6ee4ba8e84d7256"
            }
        ]
    },
    {
        "categoryName": "Video",
        "services": [
        ]
    },
    {
        "categoryName": "Music",
        "services": [
            {
                "image": "https://store-demo.centili.com/res/sf/SF_DEMO/MUSIC/4e156f1034fe7816498db1b072af7d9a.png?v=77",
                "name": "Deezer",
                "merchant": "Demo Storefront",
                "description": "Deezer is a French online music streaming service. It allows users to listen to music content from record labels, as well as podcasts on various devices online or offline.\n<br><br>\nCreated in Paris, Deezer currently has 90 million licensed tracks in its library, with over 30,000 radio channels, 100 million playlists, 16 million monthly active users, and 7 million paid subscribers as of January 2019.[4][5]\n<br><br>\nThe service is available for Web, Android, iOS, Windows Mobile, BlackBerry OS, Windows, and MacOS.",
                "serviceKey": "4e156f1034fe7816498db1b072af7d9a"
            },
            {
                "image": "https://store-demo.centili.com/res/sf/SF_DEMO/MUSIC/19ef4f9c004211340556e99c8c185c6b.png?v=77",
                "name": "Spotify ",
                "merchant": "Demo Storefront",
                "description": "Spotify is a digital music, podcast, and video service that gives you access to millions of songs and other content from creators all over the world. ",
                "serviceKey": "19ef4f9c004211340556e99c8c185c6b"
            },
            {
                "image": "https://store-demo.centili.com/res/sf/SF_DEMO/MUSIC/f35c15da5568c531dd19e8d2fba91588.png?v=77",
                "name": "StingRay ",
                "merchant": "Demo Storefront",
                "description": "Stingray is the world leading music service provider offering the best music for every moment: discover Stingray Music, Karaoke, and more!",
                "serviceKey": "f35c15da5568c531dd19e8d2fba91588"
            },
            {
                "image": "https://store-demo.centili.com/res/sf/SF_DEMO/MUSIC/47e52312d4efbc0a0e88a58fdd4a06ff.png?v=77",
                "name": "Tidal ",
                "merchant": "Demo Storefront",
                "description": "TIDAL is a global music streaming platform bringing fans closer to artists through unique experiences and the highest sound quality.",
                "serviceKey": "47e52312d4efbc0a0e88a58fdd4a06ff"
            }
        ]
    },
    {
        "categoryName": "Education",
        "services": [
            {
                "image": "https://store-demo.centili.com/res/sf/SF_DEMO/LEARNING/c08ca2c91e504b8cf7b7891fdf7ea24a.png?v=77",
                "name": "Corvus OTP Demo",
                "merchant": "Demo",
                "description": null,
                "serviceKey": "c08ca2c91e504b8cf7b7891fdf7ea24a"
            },
            {
                "image": "https://store-demo.centili.com/res/sf/SF_DEMO/LEARNING/fcdd76900fe3e428eb808e46c4c3de19.png?v=77",
                "name": "WSPay OTP Demo",
                "merchant": "Demo",
                "description": null,
                "serviceKey": "fcdd76900fe3e428eb808e46c4c3de19"
            }
        ]
    }
]

Response parameters

ParameterDescriptionExample
categoryNameName of service categoryGaming
servicesList of services for a specific category. See (https://dev.centili.com/docs/get-services-1#service){
"image":"https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/a015bd48b95345cba6ee4ba8e84d7256.png?v=77",
"name":"XBox ",
"merchant":"Demo Storefront",
"description":"Xbox Live is an online multiplayer gaming and digital media delivery service created and operated by Microsoft. The service is used by the Xbox system as well as mobile and PC devices.",
"serviceKey":"a015bd48b95345cba6ee4ba8e84d7256"
}

Service

ParameterDescriptionExample
nameA service name associated with a given serviceXBox
serviceKeyCentili-issued service key, unique for every payment service. Consists of alphanumeric characters and counts up to 32 characters.a015bd48b95345cba6ee4ba8e84d7256
descriptionA service description associated with a given serviceXbox Live is an online multiplayer gaming and digital media delivery service created and operated by Microsoft. The service is used by the Xbox system as well as mobile and PC devices.
imageAn image associated with a given servicehttps://store-demo.centili.com/res/sf/SF_DEMO/GAMING/a015bd48b95345cba6ee4ba8e84d7256.png?v=77
merchantMerchant/client name associated with a given serviceDemo Storefront

❗️

4xx client error / 5xx server error

400 - Mandatory request parameters not present
401 - Invalid credentials
404 - Domain not configured
500 - Request can not be processed at the current time

HTTP/1.1 401 Unauthorized
Content-Type: application/json

{
    "message": "Authorization failed",
    "code": "AUTH_FAILED"
}
ParameterDescriptionExample
codeError response codeAUTH_FAILED
messageError response messageAuthorization failed