Xsolla-logoXsolla Developers
or
To Publisher Account

Set SubjectServer-sideAdmin

put/merchants/{merchant_id}/promotions/{promotion_id}/subject

Sets the subject of a promotion. If the promotion is read-only (read_only = true), you cannot update the subject. The subject can take the following values: purchase, or items, or packages.

Notice

This API call does not contain the project_id path-parameter, so you need to use the API key that is valid in all the company’s projects to set up authorization.

SecuritybasicAuth
Request
path Parameters
merchant_id
required
integer

Merchant ID.

promotion_id
required
integer

Promotion ID.

Request Body schema: application/json
purchase
boolean

Whether the promotion applies to the whole purchase.

Array of objects

Array of virtual items that the promotion applies to.

Array
id
integer
localized_name
string

Plan name in default language (en), replicates name.en value.

sku
string

Item SKU.

packages
Array of objects or null

Array of virtual currency packages that the promotion applies to.

object or null

Subscription plans or products that the promotion applies to.

plans
Array of strings
products
Array of strings
max_charges_count
integer

Maximum number of billings that the promotion applies to.

digital_contents
object or null
Responses
204

No content.

Request samples
application/json
{
  • "digital_contents": null,
  • "items": [
    ],
  • "packages": null,
  • "purchase": false,
  • "subscriptions": null
}