Unsubscribe User

In order to unsubscribe user from Centili platform you must use HTTP POST method in application/json format, sent to the following URL with parameters described below:

http://api.centili.com/payment/rest/optout

POST opt-out request

URL: http://api.centili.com/payment/rest/optout
Method: POST
Content type: application/json

{
"subscriptionid":"3466xx",
"apikey":"cd309e5822e5d5d5d5d5ecc6c8d6042c2a8b",
"timestamp":"1409755651301",
"sign":"5d5ecc6c8d6042c2a8bf6t3g2a1d3b7m2v5673gf32"
}

Parameters:

Parameter
Description
Example
Required as

apikey

Centili issued service key, unique for every payment service.

f31a355df6dad07e49ba474db7ff9b07

mandatory

timestamp

Unix timestamp used to differentiate every request as a unique one. The number string represents seconds.

1462888063

mandatory

subscriptionid

Unique identifier of subscription in Centili system. If subscriptionID is used than userid parameter can be skipped.

1234567

optional

userid

If userID is used than subscriptionid parameter can be skipped.

usrId1983

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

optional

sign

Signature parameter created using key issued for signing request.

NOTE: Please refer to the signature key generation guide.

def0a0ba4f188cf174d383dc4d7f7041e358ba92

optional

Possible server responses

Server response
Meaning
Possible Error messages

HTTP 202 Accepted

User has been successfully unsubscribed.

HTTP 400 Bad request

Unsubscribe request is invalid or cannot be resolved.

-Bad request
-Mandatory parameters missing!
-Signature validation failed!
-Subscription does not exists.
-Action is not supported

HTTP 406 Not Acceptable

Opt-out transaction already exists.

There is already an outgoing opt-out process for this user.

HTTP 500 Server error.

Some unexpected internal server error has occured.

Server error.

Unsubscribe User