Метод получения данных подписки по токену подписки (V2)

Метод позволяет получить информацию о подписке по токену подписки.

Параметры взаимодействия

GET https://public-api.rustore.ru/public/glike/subscription/{packageName}/{subscriptionId}/{subscriptionToken} 

Атрибут

Тип  

Описание

Обязательность

Расположение

Пример заполнения

Public-Token

string  

Токен доступа к Public API Rustore

Да

header

packageName

string

Наименование пакета приложения

Да

path

subscriptionId

string

Код продукта-подписки

Да

path

subscriptionToken

string

Как получить токен подписки

Да

path

111.123

Параметры успешного ответа

Атрибут

Тип

Описание

Обязательность

Пример заполнения

startTimeMillis

string

Время предоставления подписки в миллисекундах с начала эпохи.

да

1577826955637

expiryTimeMillis

string

Время истечения срока действия подписки в миллисекундах с начала эпохи.

да

1609456386128

autoRenewing

boolean

Будет ли подписка автоматически продлеваться по истечении текущего срока действия.

да

false

priceCurrencyCode

string

Код валюты ISO 4217 для цены подписки.

да

RUB

priceAmountMicros

string

Цена подписки. Цена выражается в микроединицах, где 1 000 000 микроединиц представляет собой одну единицу валюты. Например, если цена подписки составляет 1,99 евро, ценаAmountMicros равна 1990000.

да

749000000

countryCode

string

Код страны/региона выставления счетов пользователя на момент предоставления подписки.

да

RU

paymentState

int

Состояние оплаты подписки. Возможные значения: 0. Ожидание платежа 1. Получение платежа 2. Бесплатная пробная версия 3. Ожидание отложенного обновления/понижения.

Отсутствует для отмененных подписок с истекшим сроком действия.

нет, только для активных подписок

1

cancelReason

int

Причина, по которой подписка была отменена или не продлевается автоматически. Возможные значения: 0. Пользователь отменил подписку 1. Подписка была отменена системой, например, из-за проблемы с оплатой 2. Подписка заменена новой подпиской 3. Подписка отменена разработчиком

нет, только для отмененных подписок со статусом CLOSED

0

orderId

string

Идентификатор счета для последнего повторяющегося заказа, связанного с покупкой подписки. Если подписка была отменена из-за отклонения платежа, это будет идентификатор счета с отклоненным платежом.

Если счетов по подписке более одного, к идентификатору добавляется их количество через разделитель ".."

да

41456..3

acknowledgementState

int

Состояние подтверждения продукта подписки. Возможные значения: 0. Ещё не подтверждено 1. Подтверждено

да

1

introductoryPriceInfo{}

object

Информация о промо периоде подписки.

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

нет, только для подписок с периодом PROMO

kind

string

Всегда передаётся значение "androidpublisher#subscriptionPurchase"

да

androidpublisher#subscriptionPurchase

purchaseType

int

Всегда передаётся значение "0"

да

0

introductoryPriceInfo{}

Атрибут

Тип

Описание

Обязательность

Пример заполнения

introductoryPriceCurrencyCode

string

Код валюты ISO 4217 для начальной цены подписки

нет, только для подписок с периодом PROMO

RUB

introductoryPriceAmountMicros

string

Начальная цена подписки. Валюта совпадает с priceCurrencyCode. Цена выражается в микроединицах, где 1 000 000 микроединиц представляет собой одну единицу валюты. Например, если цена подписки составляет 1,99 евро, ценаAmountMicros равна 1990000.

нет, только для подписок с периодом PROMO

599000000

introductoryPricePeriod

string

Период начальной цены, указанный в формате ISO 8601.  Например, «P1W» (одна неделя), «P1M» (один месяц), «P3M» (три месяца), «P6M» (шесть месяцев) и «P1Y» (один год).

нет, только для подписок с периодом PROMO

P1Y

introductoryPriceCycles

string

Количество расчетных периодов для предложения начальной цены.

нет, только для подписок с периодом PROMO

1

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

{

"startTimeMillis": "1694431707000",

"expiryTimeMillis": "1697034507000",

"autoRenewing": true,

"priceCurrencyCode": "RUB",

"priceAmountMicros": "749000000",

"countryCode": "RU",

"paymentState": 1,

"orderId": "33252..1",

"acknowledgementState": 1,

"kind": "androidpublisher#subscriptionPurchase",

"purchaseType": 0,

"introductoryPriceInfo": { "introductoryPriceCurrencyCode": "RUB", "introductoryPriceAmountMicros": "599000000

", "introductoryPricePeriod": "P1M", "introductoryPriceCycles": "1" }

}

Параметры ошибочного ответа

Атрибут

Тип

Описание

Обязательность

Пример заполнения

error{}

object

Объект с данными ошибки

Да, если код ответа !=200

error{}

Атрибут

Тип

Описание

Обязательность

Пример заполнения

code

number

http-код ответа

Да

message

date

Расшифровка кода ответа

Нет

message

code

message

400 The subscription purchase token does not match the subscription ID.
404 No subscription purchase matches the subscription ID.
Обновлено 4 октября 2023 г.
Was this information helpful?