Identify Subscription

The Centili subscription payments option allows you to automatically charge your users over mobile phone bill, on a daily, weekly or monthly basis.

There are 2 basic ways to identify if user is already subscribed and using your service:

• Unique User Identifier (server-to-server)
• User Redirection

Subscription identification using Unique User Identifier (server-to-server)

In order to identify valid subscription you need to send JSON formatted request to our subscription identification URL:

https://api.centili.com/api/payment/1_4/subscription

Parameters to be sent using POST method

If subscription identification process has been executed successfully you will get appropriate HTTP response – STATUS 200 OK.

 
JSON formatted response will contain following parameters:

Example using Unique User Identifier

• POST request you need to send:

POST https://api.centili.com/api/payment/1_4/subidentify?

{
"apikey":"278e9ea30xxxxxxx",
"userid":"60165xxxx",
"sign" : "488d3b60e3c8bf879148d1aa0c48cb31xxxxxx"
}

• The response you will receive:

HTTP Status 200 OK

{
    "status": "ACCEPTED",        
    "errorMessage": null,
    "active": "false",
    "valid": "false",
    "msisdn": "60165xxxx",
    "userId": "60165xxxx",
    "operator": "MY_DIGI",
    "expirationDate": "1452692098817",
    "subscriptionId": "3685958"
}

where:

Possible outcomes

Depending on the value of parameters activesub and validsub, these are the possible outcomes:

Subscription identification using User Redirection

❗️

warning

Please refrain from using this method without consulting Centili tech team first !

In order to identify valid subscription you need to redirect users on our identification URL.

http://api.centili.com/payment/pages/subIdentify.jsf

Parameters to be sent using GET method

After this, user will be redirected to your return URL sent in initial request and we will return user back with additional parameters which will validate subscription.

Example of Sub Identify Request

http://api.centili.com/payment/pages/subIdentify.jsf?apikey=1111111111&returnurl=http://www.merchant-example.com&timestamp=1409757900&sign=f71bfbf1c75bab0da59f4bb6cdab4b7450988f06

📘

Note:

Timestamp is additional parameter which is mandatory for each request. Timestamp parameter allows Centili platform to differentiate every request as unique one, so fraudulent activities can be eliminated together with signature through sign parameter.

Once successful identification occurs we will trigger your return URL and send following data using regular HTTP GET method:

📘

Note:

If userid is returned back than user has valid subscription under Centili System, otherwise user doesn't have valid subscription and should proceed to payment.

In example mentioned above, after initial subscription identification request is sent, following URL will be triggered based on return URL parameter that was sent in that initial request:

http://www.merchant-example.com/?userid=username&timestamp=1409755651301&sign=def0a0ba4f188cf174d383dc4d7f7041e358ba92

Next step...

Initiate Subscription