Управление покупками
Покупки (Purchases) представляют собой транзакции, которые пользователи совершают в вашей игре или приложении.
Получение списка покупок
GET /api/v1/purchases
Получает список всех покупок с опциональной фильтрацией.
Требуется авторизация: Bearer токен
Запрос
GET /api/v1/purchases?store_id=store_xyz789&is_consumed=0 HTTP/1.1
Host: `${BASE_HOST}`
Authorization: Bearer YOUR_ACCESS_TOKEN
Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
store_id | string | Нет | Фильтр по ID магазина |
is_consumed | number | Нет | Фильтр по статусу (0 - не потреблено, 1 - потреблено) |
Получение покупки по ID
GET /api/v1/purchases/{purchase_id}
Получает детальную информацию о конкретной покупке.
Требуется авторизация: Bearer токен
Потребление покупки
PUT /api/v1/purchases/consume
Отмечает покупку как потребленную. Используется для расходуемых товаров.
Требуется авторизация: Bearer токен
Запрос
PUT /api/v1/purchases/consume HTTP/1.1
Host: API_HOST
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
{
"item_name": "400_golden_coins"
}
Статусы покупок
| Статус | Описание |
|---|---|
PAID | Оплачена |
FAILED | Оплата не удалась |
VOIDED | Оплата отклонена банком после оплаты |
REFUNDED | Произошел возврат денег |
Жизненный цикл покупки
- Создание покупки - Зона ответственности SDK
- Оплата через checkout - Зона ответственности SDK
- Обновление статуса - Зона ответственности SDK
- Выдача товара игроку - Зона ответственности SDK
- Потребление покупки - PUT /api/v1/purchases/consume
Связанные разделы
- Товары - создание товаров для покупки