Get Packages

In order to get available packages for service and country or subscriber with Centili Payment API, you need to send an HTTP GET request with the appropriate service and country or subscriber.

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

GET packages for country request

URL to which a request should be sent

https://capi.centili.com/payments/v3/services/packages

https://capi.centili.com/payments/v3/services/packages?serviceKey={serviceKey}&country={country}
Host: api.centili.com:443
Content-Type: application/json
Authorization: bearer token

Request parameters

Parameter	Description	Example	Required as
serviceKey	Centili issued service key, unique for every payment service. Consists of alphanumeric characters and counts up to 32 characters.	f31a355df6dad07e49ba474db7ff9b07	mandatory
country	2 letters country parameter. We are using "ISO 3166-1 alpha-2" standard. Here is full list of 2 letter country codes.	es	mandatory

GET packages for country response

Once a request is received, Centili will synchronously respond with an appropriate HTTP response and a list of parameters and values in JSON format

👍
200
Obtained packages for country

[
    {
        "country": "rs",
        "mccmnc": "22001",
        "currency": "EUR",
        "serviceDescription": "",
        "canBill": true,
        "localCurrency": "RSD",
        "operatorCode": "RS_TELENOR",
        "packages": [
            {
                "localPayout": 42.5,
                "unit": "item",
                "amount": 1,
                "price": 0.41,
                "payout": 0.35,
                "localPrice": 50,
                "flow": "PIN"
            },
            {
                "localPayout": 63.75,
                "unit": "item",
                "amount": 2,
                "price": 0.61,
                "payout": 0.52,
                "localPrice": 75,
                "flow": "PIN"
            },
            {
                "localPayout": 85,
                "unit": "item",
                "amount": 3,
                "price": 0.81,
                "payout": 0.69,
                "localPrice": 100,
                "flow": "PIN"
            }
        ],
        "operatorName": "Telenor Serbia"
    },
    {
        "country": "rs",
        "mccmnc": "22005",
        "currency": "EUR",
        "serviceDescription": "",
        "canBill": true,
        "localCurrency": "RSD",
        "operatorCode": "RS_VIP",
        "packages": [
            {
                "localPayout": 42.08,
                "unit": "item",
                "amount": 1,
                "price": 0.41,
                "payout": 0.34,
                "localPrice": 50,
                "flow": "PIN"
            },
            {
                "localPayout": 63.11,
                "unit": "item",
                "amount": 2,
                "price": 0.61,
                "payout": 0.51,
                "localPrice": 75,
                "flow": "PIN"
            },
            {
                "localPayout": 84.15,
                "unit": "item",
                "amount": 3,
                "price": 0.81,
                "payout": 0.68,
                "localPrice": 100,
                "flow": "PIN"
            }
        ],
        "operatorName": "VIP Mobile Serbia"
    },
    {
        "country": "rs",
        "mccmnc": "22003",
        "currency": "EUR",
        "serviceDescription": "",
        "canBill": true,
        "localCurrency": "RSD",
        "operatorCode": "RS_MTS",
        "packages": [
            {
                "localPayout": 42.5,
                "unit": "item",
                "amount": 1,
                "price": 0.41,
                "payout": 0.35,
                "localPrice": 50,
                "flow": "PIN"
            },
            {
                "localPayout": 63.75,
                "unit": "item",
                "amount": 2,
                "price": 0.61,
                "payout": 0.52,
                "localPrice": 75,
                "flow": "PIN"
            },
            {
                "localPayout": 85,
                "unit": "item",
                "amount": 3,
                "price": 0.81,
                "payout": 0.69,
                "localPrice": 100,
                "flow": "PIN"
            }
        ],
        "operatorName": "m:ts Serbia"
    }
]

Response parameters

Parameter	Description	Example
country	2 letter country parameter. We are using "ISO 3166-1 alpha-2" standard. Here is full list of 2 letter country codes.	rs
mccmnc	Mobile country code and mobile network code.	22003
currency	Package currency	EUR
serviceDescirption	Description of a given service	Example one time payment service
canBill	Weather the package is billable or not	true
localCurrency	Local package currency	RSD
operatorCode	Code of Mobile Network Operator in Centili’s system which end user belongs to.	RS_MTS
operatorName	Name of Mobile Network Operator in Centili’s system which end user belongs to.	m:ts Serbia
packages	List of packages for a given service and operator. See (https://dev.centili.com/docs/get-packages-country#packages)	{ "localPayout": 42.5, "unit": "item", "amount": 1, "price": 0.41, "payout": 0.35, "localPrice": 50, "flow": "PIN" }, { "localPayout": 63.75, "unit": "item", "amount": 2, "price": 0.61, "payout": 0.52, "localPrice": 75, "flow": "PIN" },

❗️
4xx client error / 5xx server error
400 - Bad request parameters - check message for details
401 - Invalid credentials
404 - Packages not found
500 - Request can not be processed at the current time

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "code": "NOT_FOUND",
  "message": "Packages not found"
}

GET packages for subscriber request

URL to which a request should be sent

https://capi.centili.com/payments/v3/services/packages/subscribers

https://capi.centili.com/payments/v3/services/packages/subscribers?serviceKey={serviceKey}&msisdn={msisdn}
Host: api.centili.com:443
Content-Type: application/json
Authorization: bearer token

Request parameters:

Parameter	Description	Example	Required as
serviceKey	Centili issued service key, unique for every payment service. Consists of alphanumeric characters and counts up to 32 characters.	f31a355df6dad07e49ba474db7ff9b07	mandatory
msisdn	Customer mobile phone number.	4477781234567	mandatory

GET packages for subscriber response

Once a request is received, Centili will synchronously respond with an appropriate HTTP response and a list of parameters and values in JSON format:

👍
200
Obtained packages for subscriber

{
    "country": "rs",
    "mccmnc": "22003",
    "currency": "EUR",
    "localCurrency": "RSD",
    "msisdn": "381644150105",
    "operatorCode": "RS_MTS",
    "packages": [
        {
            "localPayout": 42.5,
            "price": 0.41,
            "payout": 0.35,
            "localPrice": 50,
            "flow": "PIN"
        },
        {
            "localPayout": 63.75,
            "price": 0.61,
            "payout": 0.52,
            "localPrice": 75,
            "flow": "PIN"
        },
        {
            "localPayout": 85,
            "price": 0.81,
            "payout": 0.69,
            "localPrice": 100,
            "flow": "PIN"
        },
        {
            "localPayout": 85,
            "price": 0.81,
            "payout": 0.69,
            "localPrice": 100,
            "flow": "PIN"
        }
    ],
    "operatorName": "m:ts Serbia"
}

Response parameters

Parameter	Description	Example
country	2 letter country parameter. We are using "ISO 3166-1 alpha-2" standard. Here is full list of 2 letter country codes.	rs
mccmnc	Mobile country code and mobile network code.	22003
currency	Package currency	EUR
localCurrency	Local package currency	RSD
msisdn		381644150105
operatorCode	Code of Mobile Network Operator in Centili’s system which end user belongs to.	RS_MTS
operatorName	Name of Mobile Network Operator in Centili’s system which end user belongs to.	m:ts Serbia
packages	List of packages for a given service and msisdn. See (https://dev.centili.com/docs/get-packages-country#packages)	{ "localPayout": 42.5, "price": 0.41, "payout": 0.35, "localPrice": 50, "flow": "PIN" }, { "localPayout": 63.75, "price": 0.61, "payout": 0.52, "localPrice": 75, "flow": "PIN" }

❗️
4xx client error / 5xx server error
400 - Bad request parameters - check message for details
401 - Invalid credentials
404 - Packages not found
500 - Request can not be processed at the current time

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "code": "NOT_FOUND",
  "message": "Packages not found"
}

Packages

Parameter	Description	Example
localPayout	Merchant payout in local currency	42.5
unit	Package item name being sold	item
amount	Package item amount being sold	1
price	Package price	0.41
payout	Merchant payout	0.35
localPrice	Package price in local currency	50
flow	Flow type	PIN