Получение информации о подписке
Это уведомление отправляется при открытии диалогового окна подписки через приложение.
Параметры уведомления
Название параметра | Примечение |
---|---|
app_id integer | Идентификатор приложения. |
item string | Наименование товара, переданное диалоговому окну подписки. |
lang string | Язык пользователя в формате язык_страна . Сейчас поддерживается 4 языка: ru_RU — русский, uk_UA — украинский, be_BY — белорусский, en_US — английский. |
notification_type string | Тип уведомления. Равен get_subscription или get_subscription_test . |
order_id integer | Идентификатор заказа в системе платежей ВКонтакте. |
receiver_id integer | Идентификатор получателя заказа (совпадает с user_id , но в будущем может отличаться). |
user_id integer | Идентификатор пользователя, создавшего заказ. |
sig string | Подпись уведомления (см. Проверка подписи). |
Параметры ответа
По полученному в уведомлении наименованию товара item
разработчик должен вернуть актуальную информацию о нём. При отсутствии товара необходимо выдать в ответе ошибку 20, «Подписки не существует».
Внимание! Так как
item
передаётся на клиентской стороне, этот параметр может быть изменён пользователем.
Название параметра | Примечение |
---|---|
item_id integer | Идентификатор товара в приложении. |
title string , обязательный | Название подписки. |
description string | Описание подписки. |
photo_url string | URL изображения для подписки на сервере разработчика. |
price integer | Стоимость подписки в голосах. |
period integer | Период действия подписки. Возможные значения: 7 — 7 дней, 30 — 30 дней, 90 — 90 дней. |
trial_duration integer | Длительность триал-периода. Возможные значения: 3 — 3 дня, 7 — 7 дней, 30 — 30 дней. |
expiration integer | Разрешает кэширование товара на {expiration} секунд. Допустимый диапазон от 600 до 604800 секунд. Важно! При отсутствии параметра возможно кэширование товара на 3600 секунд при большом количестве подряд одинаковых ответов. Для отмены кэширования необходимо передать 0 в качестве значения параметра. |
Если expiration = 0
или не определён, то для подписки с одним идентификатором item
допускается возвращать различные названия, изображения и цены.
Внимание! Рекомендуется всегда использовать кэширование, чтобы пользователи не ожидали получения информации, и чтобы уменьшить количество обращений к серверу приложения.
Пример ответа
JSON
{
"response": {
"item_id":50,
"title":"VIP Status",
"photo_url":"http:\/\/vk.com\/images\/gift\/90\/96.jpg",
"price":1,
"period":7,
"trial_duration":7,
"expiration":600
}
}