Initiate Subscription

In order to initiate subscription, request must be sent as HTTPS POST with Content-Type: application/json composed of parameters with associated values.

URL to which request should be posted:

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

POST subscribe request

POST https://api.centili.com/api/payment/1_4/subscribe HTTP/1.1
Host: api.centili.com:443
Content-Type: application/json

{
"apikey":"2ea0e6c989b433d6c591633f91c67e07",
"price":"6.05",
"mno":"ES_VODAFONE",
"returnurl":"http://www.yourwebsite.com"
}

All possible initiation parameters:

🚧

Keep in mind:

"mno" parameter is:

• mandatory for 3G flow, with value equal to value of "operator" parameter received in previous Identify User response

• mandatory for WiFi flow as well, but only if used instead of "msisdn" parameter (supported for certain Mobile Network Operators).

• mccmnc parameter can be sent instead of parameter ''mno"

POST payment response

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

HTTP/1.1 200 OK
Content-Type: application/json

{
 "status":"ACCEPTED",
"transactionid":"123456789"
"clientid": “xxxxxxxxx”,
"action": “URL_REDIRECT”,
"redirecturl":” http://www.exampleURL.com”,
"sessionStatus": “PENDING”,
"countryCode": “es”,
"apiKey":”123456abcdefg” 
}

Response parameters:

Once transaction reaches a final state Payment Result Notification will be delivered to your system.

Instructions depending on the "Action" parameter value

Regulate further flow according to data received in our response:

📘

Payment flows

To help you understand these instructions, there are few types of payment flow, depending on the billing technology available in the country of your target:

• PIN flow
• Premium SMS flow
• Handshake flow
• URL Redirect flow