Поля получения

Получения составлены из многих полей. Некоторые поля только доступны локально, в форме ASN.1 получения, или только при проверке с App Store, в форме JSON получения. Ключи, не задокументированные ниже, резервируются для использования Apple и должны быть проигнорированы Вашим приложением.

Поля получения приложения

Идентификатор пакета

Идентификатор пакета приложения.

Тип поля ASN.1 2

Значение поля UTF8STRING ASN.1

Имя поля JSON bundle_id

Строка Значения поля JSON

Это соответствует значению CFBundleIdentifier в Info.plist файл.

Версия приложения

Номер версии приложения.

Тип поля ASN.1 3

Значение поля UTF8STRING ASN.1

Имя поля JSON application_version

Строка Значения поля JSON

Это соответствует значению CFBundleVersion (в iOS) или CFBundleShortVersionString (в OS X) в Info.plist.

Непрозрачное значение

Непрозрачное используемое значение, с другими данными, для вычислений хеша SHA 1 во время проверки.

Тип поля ASN.1 4

Значение поля ASN.1 ряд байтов

Имя поля JSON (ни один)

Значение поля JSON (ни один)

Хеш SHA 1

Хеш SHA 1, используемый для проверки получения.

Тип поля ASN.1 5

Обзор SHA 1 20 байтов Значения поля ASN.1

Имя поля JSON (ни один)

Значение поля JSON (ни один)

Получение закупки в приложении

Получение для закупки в приложении.

Тип поля ASN.1 17

Значение поля ASN.1 SET закупки в приложении подтверждает получение атрибутов

Имя поля JSON in_app

Массив Значения поля JSON получений закупки в приложении

В файле JSON значение этого ключа является массивом, содержащим все получения закупки в приложении. В файле ASN.1 существуют многократные поля, что у всех есть тип 17, каждый из которых содержит единственное получение закупки в приложении.

Когда покупка совершена, получение закупки в приложении для потребляемого продукта добавляется к получению. Это сохранено в получении до Ваших концов приложения та транзакция. После той точки это удалено из получения в следующий раз, когда получение обновляется — например, когда пользователь совершает другую покупку или если Ваше приложение явно обновляет получение.

Получение закупки в приложении для непотребляемого продукта, автовозобновляемой подписки, невозобновляя подписку или бесплатную подписку остается в получении неопределенно.

Версия исходного приложения

Версия первоначально купленного приложения.

Тип поля ASN.1 19

Значение поля UTF8STRING ASN.1

Имя поля JSON original_application_version

Строка Значения поля JSON

Это соответствует значению CFBundleVersion (в iOS) или CFBundleShortVersionString (в OS X) в Info.plist файл, когда была первоначально совершена покупка.

В среде песочницы значение этого поля всегда «1.0».

Получения до 20 июня 2013 опускают это поле. Это заполняется на всех новых получениях, независимо от версии ОС. Если Вам нужно поле, но оно отсутствует, вручную обновите получение с помощью SKReceiptRefreshRequest класс.

Подтвердите получение даты истечения срока

Дата, что истекает получение приложения.

Тип поля ASN.1 21

Значение поля IA5STRING ASN.1, интерпретируемое как дата RFC 3339

Имя поля JSON expiration_date

Значение поля IA5STRING JSON, интерпретируемое как дата RFC 3339

Этот ключ присутствует только для приложений, купленных через Программу Закупки Объема. Если этот ключ не присутствует, получение не истекает.

При проверке получения сравните эту дату с текущей датой, чтобы определить, истекает ли получение. Не пытайтесь использовать эту дату для вычисления любой другой информации, такой как время, оставаясь перед истечением срока.

Поля получения закупки в приложении

Количество

Число элементов куплено.

Тип поля ASN.1 1701

Значение поля ASN.1 INTEGER

Количество Имени поля JSON

Строка Значения поля JSON, интерпретируемая как целое число

Это значение соответствует quantity свойство SKPayment объект хранится в транзакции payment свойство.

Идентификатор продукта

Идентификатор продукта купленного элемента.

Тип поля ASN.1 1702

Значение поля UTF8STRING ASN.1

Имя поля JSON product_id

Строка Значения поля JSON

Это значение соответствует productIdentifier свойство SKPayment объект хранится в транзакции payment свойство.

Идентификатор транзакции

Идентификатор транзакции купленного элемента.

Тип поля ASN.1 1703

Значение поля UTF8STRING ASN.1

Имя поля JSON transaction_id

Строка Значения поля JSON

Это значение соответствует транзакции transactionIdentifier свойство.

Исходный идентификатор транзакции

Для транзакции, восстанавливающей предыдущую транзакцию, идентификатор транзакции исходной транзакции. Иначе, идентичный идентификатору транзакции.

Тип поля ASN.1 1705

Значение поля UTF8STRING ASN.1

Имя поля JSON original_transaction_id

Строка Значения поля JSON

Это значение соответствует исходной транзакции transactionIdentifier свойство.

Все получения в цепочке возобновлений для автовозобновляемой подписки имеют то же значение для этого поля.

Дата покупки

Дата и время, что был куплен элемент.

Тип поля ASN.1 1704

Значение поля IA5STRING ASN.1, интерпретируемое как дата RFC 3339

Имя поля JSON purchase_date

Строка Значения поля JSON, интерпретируемая как дата RFC 3339

Это значение соответствует транзакции transactionDate свойство.

Для транзакции, восстанавливающей предыдущую транзакцию, дата покупки является датой восстановления. Используйте Исходную Дату покупки для получения даты исходной транзакции.

В автовозобновляемом получении подписки это - всегда дата, когда подписка была куплена или возобновлена, независимо от того, была ли восстановлена транзакция.

Исходная дата покупки

Для транзакции, восстанавливающей предыдущую транзакцию, дату исходной транзакции.

Тип поля ASN.1 1706

Значение поля IA5STRING ASN.1, интерпретируемое как дата RFC 3339

Имя поля JSON original_purchase_date

Строка Значения поля JSON, интерпретируемая как дата RFC 3339

Это значение соответствует исходной транзакции transactionDate свойство.

Даже если подписка была возобновлена, в автовозобновляемом получении подписки это указывает начало периода подписки.

Дата истечения срока подписки

Дата истечения срока подписки, выраженной как число миллисекунд с 1 января 1970, 0:00:00 GMT.

Тип поля ASN.1 1708

Значение поля IA5STRING ASN.1, интерпретируемое как дата RFC 3339

Имя поля JSON expires_date

Число Значения поля JSON

Этот ключ только присутствует для автовозобновляемых получений подписки.

Дата отмены

Для транзакции, отмененной поддержкой клиентов Apple, время и дата отмены.

Тип поля ASN.1 1712

Значение поля IA5STRING ASN.1, интерпретируемое как дата RFC 3339

Имя поля JSON cancellation_date

Строка Значения поля JSON, интерпретируемая как дата RFC 3339

Обработайте отмененное получение то же, как будто никогда не совершалась никакая покупка.

Элемент приложения ID

Строка, что использование App Store для однозначного определения приложения, создавшего транзакцию.

Тип поля ASN.1 (ни один)

Значение поля ASN.1 (ни один)

Имя поля JSON app_item_id

Строка Значения поля JSON

Если Ваш сервер поддерживает многократные приложения, можно использовать это значение для дифференциации между ними.

Приложения присваиваются идентификатор только в продуктивной среде, таким образом, этот ключ не присутствует для получений, создаваемых в тестовой среде.

Это поле не присутствует для приложений Mac.

См. также Идентификатор Пакета.

Внешний идентификатор версии

Произвольное число, однозначно определяющее версию Вашего приложения.

Тип поля ASN.1 (ни один)

Значение поля ASN.1 (ни один)

Имя поля JSON version_external_identifier

Строка Значения поля JSON

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

Позиция интернет-заказа ID

Первичный ключ для идентификации покупок подписки.

Тип поля ASN.1 1711

Значение поля ASN.1 INTEGER

Имя поля JSON web_order_line_item_id

Строка Значения поля JSON