Подтверждение покупки

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

подсказка

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

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

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

PUT

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

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

PUT

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

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

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

Атрибут	Тип	Описание	Обязательность	Расположение	Пример
code	string	Код ответа	Да	body	• ОК; •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	Покупка не найдена. Убедитесь, что указан корректный идентификатор покупки.
You can confirm purchase only once every 15 minutes. Try again later	Повторное подтверждение одной и той же покупки доступно только раз в 15 минут. Повторите запрос позже.
Forbidden	Запрещено. Проверьте правильность токена авторизации и параметров запроса.
Something went wrong	Что-то пошло не так. Попробуйте позже или обратитесь в поддержку.