Unsubscribe User

In order to unsubscribe user from Centili platform you must use HTTPS POST method in application/json format. Before initiating request you will need to obtain tokenURL. After obtaining the bearer token send your request to the following URL with parameters described below.


POST opt-out request

URL: https://api.centili.com/payments/v3/subscriptions/5006180200/cancel
Method: POST
Content type: application/json
Authorization: bearer eyJhbGciOiJSUzUxMiI...
  • The response you will receive:
HTTP/1.1 200 OK
Content-Type: application/json
"clientUserId": "c43b7e44-609d-4dde-be33-xxxxxxxx",
"clientReference": null
"subscriptionId": "500618020220",
"transactionId": "1764170157220"





Required as


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



Possible server responses

Server response


Possible Error messages

HTTP 202 Accepted

User has been successfully unsubscribed.

HTTP 400 invalid 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.

Example of response for bad request:

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

Updated 3 months ago

Unsubscribe User

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.