Initiate Payment

In order to initiate payment with [CentiliPaymentAPI], you need to send request 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/transaction

POST payment request

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

{
"apikey":"2ea0e6c989b433d6c591633f91c67e07",
"price":"6.05",
"country":"es",
"msisdn":"34666xxxxxx"
}

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 a 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