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	Вы уже активировали код из этой серии купонов, активация второго купона невозможна
101203	Coupons limit for the campaign has been reached	Достигнут лимит купонов на кампанию
103005	You haven't picked up the book yet	Уведомление пользователя, что книга по абонементу еще не взята при продлении по купону
101307	Coupon is for new users only	Купон предназначен только для новых пользователей
101306	Rebill is required to activate the coupon	Купон требует предварительной привязки ребилла
103008	Can't renew a subscription purchased on the Appstore with a coupon	Продление Литрес Подписки, приобретенной через AppStore, с помощью сертификата невозможно.

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

{
  "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"
   }
}

Public : [w_activate_coupon] Активация купона