Получение информации о подписке

Это уведомление отправляется при открытии диалогового окна подписки через приложение.

Параметры уведомления

Название параметраПримечение
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 stringURL изображения для подписки на сервере разработчика.
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 } }