Подтверждение покупки
Метод позволяет подтвердить покупку (списать ранее зарезервированные средства с карты пользователя) по идентификатору покупки и приложения. Применяется только для покупок потребляемых товаров (двухстадийная оплата) в статусе 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
| Атрибут | Тип | Описание | Обязательность | Расположение | Пример |
|---|---|---|---|---|---|
Public-Token | string | Jwe-токен авторизации в Public API Rustore. Как получить токен авторизации. | Да | header | N/A |
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 | Что-то пошло не так. Попробуйте позже или обратитесь в поддержку. |