---
title: "Subscription Purchase Endpoint"
method: POST
path: "/miniapp/subscription/purchase"
tags: ["miniapp"]
---

# Subscription Purchase Endpoint

`POST /miniapp/subscription/purchase`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/docs/miniapp/subscription/purchase/post.ts> (a function with typed inputs; its response is checked against the schema)

Оформление покупки подписки.

## Request body

- MiniAppSubscriptionPurchaseRequest
  - `initData` string, required
  - `subscriptionId` integer, nullable
  - `selection` object, nullable
  - `periodId` string, nullable
  - `periodDays` integer, nullable
  - `period` string, nullable
  - `trafficValue` integer, nullable
  - `traffic` integer, nullable
  - `trafficGb` integer, nullable
  - `servers` string[], nullable
  - `countries` string[], nullable
  - `serverUuids` string[], nullable
  - `devices` integer, nullable
  - `deviceLimit` integer, nullable

## Response `200`

Successful Response

- MiniAppSubscriptionPurchaseResponse
  - `success` boolean
  - `message` string, nullable
  - `balanceKopeks` integer, nullable
  - `balanceLabel` string, nullable
  - `subscriptionId` integer, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `2360876ff9c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/changes/miniapp/subscription/purchase/post.md)

---

[API](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api.md) - [All operations](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/revisions/2360876ff9c5?raw)