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:


POST opt-out request

URL: https://api.centili.com/api/payment/1_4/unsubscribe
Method: POST
Content type: application/json

"apikey":" cd309e5822e5d5d5d5d5ecc6c8d6042c2a8b",
“sign”:” 5d5ecc6c8d6042c2a8bf6t3g2a1d3b7m2v5673gf32”
  • The response you will receive:
HTTP/1.1 200 OK
Content-Type: application/json
    "status": "ACCEPTED",
    "errorMessage": ""


ParameterDescriptionExampleRequired as
apikeyCentili issued service key, unique for every payment service.f31a355df6dad07e49ba474db7ff9b07 mandatory
subscriptionidUnique identifier of subscription in Centili system. If subscriptionID is used than userid parameter can be skipped.1234567optional
useridIf 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.
signSignature parameter created using key issued for signing request.

NOTE: Please refer to the signature key generation guide.

Possible server responses

Server responseMeaningPossible Error messages
HTTP 202 AcceptedUser has been successfully unsubscribed.
HTTP 400 invalid requestUnsubscribe 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 AcceptableOpt-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.

Example of response for bad request:

    "status": "INVALID_REQUEST",
    "errorMessage": "Subscription does not exists."