Apply Discount

This endpoint allows you to apply a previously created discount to an existing subscriber's active subscription.

Before using this endpoint, create a discount in the Zotlo Panel under Catalog > Discounts. Once the discount has been created, it can be applied to an eligible subscriber's active subscription through this API.

Method	POST
URL	https://api.zotlo.com/v2/subscription/add-discount

Request Parameters

Field	Type	Description
subscriberId	Required	The email, phone number the user provided when starting the subscription.
discountCode	Required	The ID of the current active package. A successful response is returned only if the user has a subscription for this package.
packageId	Required	The ID of the subscription package to which the discount will be applied. The subscriber must have an active subscription to this package

Sample Request

POST https://api.zotlo.com/v1/subscription/cancellation HTTP/1.1
AccessKey: ••••••
AccessSecret: ••••••
Content-Type: application/json
ApplicationId: •
Language: en

{
  "subscriberId": "[e-mail]",
  "packageId": "test_1234",
  "discountCode": "FRIDAY20"
}

You can find your AccessKey and AccessSecret in the Zotlo Panel under Developer Tools → API Keys

Sending ApplicationId is optional.

Successful Response

{
    "meta": {
        "requestId": "192-168-1-115.eu-central-1.compute.internal-REQ-6a5dd47879845",
        "httpStatus": 200
    },
    "result": {
        "message": "Discount applied successfully"
    }
}

Failed Response

All failed responses follow the same standard error format. (See: Error Handling)