REST Resource: purchases.voidedpurchases

Источник: VoidedPurchase

Объект VoidedPurchase указывает на покупку, которая была отменена, возвращена или аннулирована платежом.

JSON-представление 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
Поля
kind

string

Этот тип данных представляет собой аннулированный объект покупки в службе androidpublisher.

purchaseToken

string

Токен, однозначно идентифицирующий разовую покупку или подписку. Для однозначной идентификации продления подписки используйте orderId (доступен начиная с версии 3 API).

purchaseTimeMillis

string ( int64 format)

Время совершения покупки в миллисекундах с начала эпохи (1 января 1970 г.).

voidedTimeMillis

string ( int64 format)

Время, в которое покупка была отменена/возвращена/отменена, в миллисекундах с начала эпохи (1 января 1970 г.).

orderId

string

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

voidedSource

integer

Инициатор аннулированной покупки, возможные значения: 0. Пользователь 1. Разработчик 2. Google

voidedReason

integer

Причина аннулирования покупки, возможные значения: 0. Другое 1. Сожаление 2. Не получено 3. Дефектный товар 4. Случайная покупка 5. Мошенничество 6. Дружеское мошенничество 7. Возврат платежа 8. Неподтвержденная покупка

voidedQuantity

integer

Аннулированное количество является результатом частичного возврата средств, основанного на количестве. Аннулированные покупки, по которым был произведен частичный возврат средств, основанный на количестве, могут быть возвращены только в том случае, если параметр includeQuantityBasedPartialRefund установлен в значение true.

Методы

list

 В списке отображаются покупки, которые были отменены, возвращены или аннулированы.

коды ошибок

При работе с этим ресурсом возвращаются следующие коды ошибок HTTP:

Код ошибки Причина Описание Разрешение
400 invalidValue В запросе было предоставлено недопустимое значение. Такая ошибка часто возникает при получении некорректного или недействительного токена покупки. Исправьте недопустимое значение поля в теле запроса или параметрах в соответствии со справочником API.
400 required В запросе отсутствует обязательное поле или параметр. Ознакомьтесь с документацией API, чтобы убедиться в наличии всех обязательных полей и параметров.
403 userInsufficientPermission У пользователя недостаточно прав для выполнения запрошенной операции. Убедитесь, что авторизованный пользователь имеет необходимые разрешения в консоли Google Play. Дополнительные сведения см. в разделе «Использование служебной учетной записи» .
404 notFound Запрошенный ресурс не найден. Убедитесь в правильности идентификаторов (например, токен покупки, название пакета, идентификатор продукта, идентификатор подписки).
409 concurrentUpdate Была предпринята попытка обновить объект, который обновляется одновременно с первым. Повторите запрос с экспоненциальной задержкой. Избегайте одновременных изменений одного и того же ресурса.
5xx Generic error Общая ошибка на сервере Google Play. Повторите запрос.

Если проблема не исчезнет, ​​обратитесь к своему менеджеру аккаунта Google Play или отправьте запрос в службу поддержки. Рекомендуем проверить панель состояния Play на наличие известных сбоев.