Настройка вознаграждений

Xsolla Developers

или

Настройка вознагражденийServer-sideAdmin

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

Устанавливает вознаграждения за участие в акции. Если акция доступна только для чтения (read_only = true), вы не сможете обновить вознаграждения.

Внимание

Этот метод API не включает в себя path-параметр project_id, поэтому для авторизации вам необходимо использовать ключ API, который действует во всех проектах.

SecuritybasicAuth

Request

path Parameters

merchant_id required	integer ID продавца.
promotion_id required	integer ID акции.

Request Body schema: application/json

object

Настройка вознаграждения при покупке предмета.

Array of objects

Вознаграждение в виде бесплатного предмета.

Array

id	integer
localized_name	string Название плана языке по-умолчанию. Повторяет значение name.en.
quantity	integer Количество предметов.
sku	string Артикул предмета.

Array of objects

Настройка скидки при покупке предмета.

Array

discount_percent	number <float> Скидка на покупку, %.
localized_name	string Название плана языке по-умолчанию. Повторяет значение name.en.
max_amount	number <integer> Максимальное количество предметов, на которое будет распространяться акция.
sku	string Артикул предмета.

object

Настройка вознаграждения при покупке пакета виртуальной валюты.

bonus_amount	number <float> Вознаграждение, указанное в виде абсолютного значения количества виртуальной валюты.
bonus_percent	number <float> Вознаграждение, указанное в виде процента от количества виртуальной валюты.

object

Настройка вознаграждения на весь заказ.

discount_percent

number <float>

Скидка на покупку, %.

object

Настройка вознаграждения на подписку.

trial_days

integer

Количество дней триального периода.

Responses

204

No content.

Request samples

application/json

{"item": {"bonus": [{"quantity": 2,
"sku": "1234"
}
],
"discount": [{"discount_percent": 5,
"max_amount": 10,
"sku": "1234"
}
]
},
"package": {"bonus_amount": 5,
"bonus_percent": 5
},
"purchase": {"discount_percent": 10
},
"subscription": {"trial_days": 30
}
}