apikey

Centili issued service key, unique for every payment service. Consists of alphanumeric characters and counts up to 32 characters.

f31a355df6dad07e49ba474db7ff9b07

mandatory both for 3G and WiFi flow

price

End user price for an ongoing
transaction.

1.45

mandatory both for 3G and WiFi flow

priceid

Identifier of a specific package under Centili platform.

324

optional

User

Customer identification ID for specific flows

customer email address
or account username or other customer identification ID

(mandatory when msisdn or identid is missing)
In specific flows where MSISDN is not parameter for customer identification you can use "user" to set customer identity (email adrress or account username)

mno

Code of Mobile Network Operator in Centili’s system which end user belongs to.

ES_VODAFONE
(for Vodafone Spain)

mandatory / optional
Look for "Keep in mind" callout box underneath this table.

mccmnc

Mobile country code and mobile network code.

23201
(for A1 Telekom Austria)

optional
Look for "Keep in mind" callout box underneath this table.

msisdn

Customer mobile phone number.
NOTE: The number must be in E.164 format, excluding the plus ("+") character.

4477781234567

optional
(mandatory for WiFi flow)
Look for "Keep in mind" callout box underneath this table.

clientid

Unique identification parameter under your system (pass-through variable).

appID1

optional

userid

Identification of the customer.

usrId1983

NOTE: If the value is not set within payment request, this field will contain MSISDN of the particular customer.

optional

username

Configured under Partner Panel service, it is used only if API authentication is activated.

username

optional

password

Configured under Partner Panel service, it is used only if API authentication is activated.

password

optional

identid

ID of the identification transaction that preceded the payment request.

123456789

optional
(mandatory for 3G flow)

country

2 letters country parameter. We are using "ISO 3166-1 alpha-2" standard. Here is full list of 2 letter country codes.

es

optional

params

Special additional parameter. Allows adding design_id parameter in request if merchant want customized payment page. Any page customization must be allowed by MNO.

[{"name":"design_id","value":"1"}]

optional

returnurl

URL to which user is redirected after payment.

http://www.example.com

optional (mandatory for url redirect flows)

status

Indicates status of the current request.

Possible values:

• ACCEPTED
• CHARGING_FAILED
• INVALID_REQUEST
• INVALID_SERVICE
• UNAUTHORIZED
• INACTIVE
• INVALID_MSISDN
• INVALID_OPERATOR_CODE
• INVALID_MCCMNC
• INVALID_PRICE
• DAILY_LIMIT_EXCEEDED
• MONTHLY_LIMIT_EXCEEDED

errorMessage

Error description in case of failed transaction request.

Bad request

transactionId

Unique identifier of transaction in Centili system.

123456789

apikey

Centili issued service key, unique for every payment service. Consists of alphanumeric characters and counts up to 32 characters.

f31a355df6dad07e49ba474db7ff9b07

clientId

Unique identification parameter under your system (pass-through variable reference; max length: 256 characters).

appID1

price

End user price for specific transaction.

1.45

countryCode

Two-letter ISO 31661 international standard code.

FR
(for France)

operatorCode

Code of Mobile Network Operator in Centili’s system which end user belongs to.

ES_VODAFONE
(for Vodafone Spain)

mcc

Mobile country code.

232
(example for Austria)

mnc

Mobile network code.

01

msisdn

Customer mobile phone number.
NOTE: The number must be in E.164 format, excluding the plus ("+") character.

4477781234567

action

Signifies type of flow for the initiated transaction.

Possible values:

• URL_REDIRECT
• PREMIUM
• PIN
• HANDSHAKE

NOTE: look for these instructions how to regulate further flow according to data received in our response (underneath this table).

sessionStatus

Indicatior of current state of transaction.

Possible values:

• PENDING
• FAILED
• COMPLETED

urlRedirect

URL to which user should be redirected in order to continue with payment process (delivered only if action=URL_REDIRECT).

premiumInstructions

Instruction containing keyword and shortcode user needs to configure a confirmation MO message before sending (delivered only if action=PREMIUM).

"Please send GO to 1234 in order to confirm purchase."

NOTE: instruction is displayed in a local language. Check our country coverage.

shortCode

Shortcode contained in premium instruction (delivered only if action=PREMIUM).

1234

smsBody

Keyword contained in premium instruction (delivered only if action=PREMIUM).

GO

handshakeInstructions

Text instructing user to reply to the received MT message in order to confirm payment (delivered only if action=HANDSHAKE).

"Please send YES to 1234 in order to confirm purchase."

NOTE: message is sent in a local language. Check our country coverage.

URL_REDIRECT

Redirect user to URL provided as a value of urlRedirect parameter mentioned in the table above.

Once redirected, you should expect that user will be returned to URL provided in your initial request under returnurl parameter, according to the logic described in Redirect after Payment guide.

PREMIUM

You have two options:

• Display instruction message to user, using text you received in Centili response under premiumInstructions parameter,
• Use Short code and Keyword you received in response under shortCode and smsBody parameters and create instruction message on your own.

Once transaction reaches a final state, next step is Payment Result Notification which will be delivered to URL defined under your Partner Panel service.

PIN

Please refer to PIN Payment Flow Update guide for complete reference how to forward PIN after user enters it and track its status.

HANDSHAKE

Display instruction message to user containing text you received in Centili response under handshakeInstructions parameter.

Once transaction reaches a final state, next step is Payment Result Notification which will be delivered to URL defined under your Partner Panel service.