POST /api/v1/payments/buy-premium

Purchases a premium account for the authenticated user.

Permissions

Request Body Parameters

Use /prices to get plan names and discount rates.

Request Example

{
  "plan": "plus",
  "months_count": 12
}

Response

201 Created

Returns the created user premium subscription resource.

Example

{
  "id": 1,
  "user_id": 42,
  "plan": "plus",
  "starts_at": "2025-01-01 00:00:00",
  "expires_at": "2026-01-01 00:00:00"
}

For a full schema, see User Premium Subscription Resource.

Error Responses