ID функции

w_activate_coupon

Кто может вызывать

Авторизованный пользователь.
Авторизованное приложение.

Принимаемые параметры

code* – код купона, который пользователь пытается активировать.

Возвращаемые значения

coupone_info – информация о том, какие бонусы содержит купон. Возможны следующие элементы:

  • bonus_arts – массив идентификаторов книг, которые нужно добавить пользователю;
  • slonogifts – информация об активированной «раздаче слонов». Содержит:
  • collection – идентификатор коллекции, из которой пользователь может взять книги;
  • count – количество книг, которые пользователь может взять из указанной коллекции;
  • discount – скидка на книги. Содержит:
  • art_type – перечисленные через запятую типы книг, на которые распространяется скидка. См. возвращаемые значения параметра type метода r_search_arts;
  • percent – процент скидки, например ;
  • days – количество дней, в течение которых действует скидка. Число;
  • discount_collection – скидочная коллекция;
  • real_money – количество денег, добавленных на счет пользователя;
  • bonus_money – количество бонусов, добавленных на счет пользователя;
  • conditions – условия, которые необходимо выполнить пользователю для того, чтобы получить бонусы.

Возможные ошибки

error_code

error_message

Описание

101104

Invalid coupone code format

Неверный формат кода купона

101105

This coupone already used

Этот купон уже был использован

101106

Redeem this coupon you can only after a deposit in the amount of one hundred rubles and above

Этот купон вы можете использовать только после пополнения счёта на сумму от ста рублей и выше

101107

Invalid coupon code

Неверный код купона

101108

This coupon has expired

Срок действия этого купона истек

101109

You have already activated the code in this series, the activation of the second coupon is impossible

Вы уже активировали код из этой серии купонов, активация второго купона невозможна

101203Coupons limit for the campaign has been reachedДостигнут лимит купонов на кампанию

Пример запроса на сервер

{
  "sid": "f121e02084344f06da1a5213999e8fcG",
  "app": "1",
  "time": "2019-12-14T16:11:18+03:00",
  "sha": "b7952956569bef3c685d3453316b5c",
  "requests": [
		 {
            "func": "w_activate_coupon"
            "id": "w_activate_coupon_code"
            "param": {
                  "code": "ЛИТРЕС"
                }
            },
        ]
    );
}

Пример ответа сервера

{
   "success" : true,
   "time" : "2019-12-14T16:11:18+03:00",
   "w_activate_coupon_code" : {
   		"coupone_info" : {
   			"discount" : {
            	"art_type" : "0,1,4",
            	"days" : 30,
            	"percent" : "0.10",
            	"type" : "discount"
         		}
			"slonogifts" : [
            {
               "collection" : "4658",
               "count" : 1
            }
         ]
      },
   "success" : true
   }
}

Пример ответа сервера с ошибкой

{
   "success" : true,
   "time" : "2019-12-14T16:21:38+03:00",
   "w_activate_coupon_code" : {
      "success" : false,
      "error_message" : "This coupon has expired",
      "error_code" : 101108,
      "time" : "2019-12-14T16:21:38+03:00"
   }
}