Отмена покупки

Метод позволяет отменить покупку (отменить блокировку средств на карте пользователя) по идентификатору покупки и приложения. Применяется только для покупок потребляемых товаров (двухстадийная оплата) в статусе PAID.

подсказка

Если не знаете с чего начать, прочтите инструкцию в сценариях использования.

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

Для реальных покупок:

PUT

https://public-api.rustore.ru/public/applications/{appId}/purchases/{purchaseId}:cancel

Для тестовых покупок:

PUT

https://public-api.rustore.ru/public/sandbox/applications/{appId}/purchases/{purchaseId}:cancel

Атрибут	Тип	Описание	Обязательность	Расположение	Пример
appId	number	Идентификатор приложения из RuStore консоли. 1. Перейдите на вкладку Приложения и выберите нужное приложение. 2. Скопируйте идентификатор из URL-адреса страницы приложения — это набор цифр между apps/ и /versions.	Да	path	1704024
purchaseId	string	Идентификатор покупки в формате UUID. Можно получить из результата покупки через SDK, из уведомления на сервер или запросом информации о покупке.	Да	path	3aa0c7bd-964e-4562-b218-fe365adb4ae3

Параметры ответа

Атрибут	Тип	Описание	Обязательность	Расположение	Пример
code	string	Код ответа	Да	body	OK, ERROR, BAD_REQUEST, NOT_FOUND и т.д.
message	string	Расшифровка кода ответа	Нет	body	Purchase status must be PAID
body	object	Тело ответа	Нет	body	{}
timestamp	string	Время ответа	Да	body	2025-04-01T15:02:09.427Z

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

{
  "code": "OK",
  "message": null,
  "body": {},
  "timestamp": "2025-04-01T15:02:09.427Z"
}

Пример ответа с ошибкой

{
  "code": "ERROR",
  "message": "Purchase status must be PAID",
  "body": null,
  "timestamp": "2025-04-01T15:02:09.427Z"
}

Список ошибок

Message	Расшифровка
Purchase status must be PAID	Статус покупки должен быть PAID. Убедитесь, что указан корректный идентификатор покупки.
Purchase not found	Покупка не найдена. Убедитесь, что указан корректный идентификатор покупки.
Forbidden	Запрещено. Проверьте правильность токена авторизации и параметров запроса.
Something went wrong	Что-то пошло не так. Попробуйте позже или обратитесь в поддержку.