Баланс

Методы для работы с балансом аккаунта: история, расчёт стоимости, пополнение.

Обзор

Модуль для работы с балансом аккаунта. Позволяет рассчитывать стоимость пополнения и пополнять баланс.

GET /profile/balance/calculate

Рассчитать стоимость пополнения баланса.

Rate Limit: 5 req/sec

Query Parameters

Parameter	Type	Required	Description
`amount`	number	Да	Сумма в рублях (100-15000)

Пример запроса

curl -X GET "https://api.stealthsurf.app/profile/balance/calculate?amount=500" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY"

Ответ

{
  status: true,
  statusCode: 200,
  data: Array<{
    id: number
    method_key: string      // sbp | ton | etc.
    display_name: string    // Название способа оплаты
    price: number           // Стоимость в валюте
    currency: string        // RUB | TON | etc.
  }>
}

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

{
  "status": true,
  "statusCode": 200,
  "data": [
    {
      "id": 1,
      "method_key": "sbp",
      "display_name": "СБП",
      "price": 500,
      "currency": "RUB"
    },
    {
      "id": 3,
      "method_key": "ton",
      "display_name": "TON",
      "price": 1.25,
      "currency": "TON"
    }
  ]
}

POST /profile/balance/topup

Пополнить баланс.

Rate Limit: 1 req/sec

Request Body

Field	Type	Required	Description
`amount`	number	Да	Сумма в рублях (100-15000)
`payment_method_id`	number	Да	ID способа оплаты

Пример запроса

curl -X POST "https://api.stealthsurf.app/profile/balance/topup" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500,
    "payment_method_id": 1
  }'

Ответ

{
  status: true,
  statusCode: 200,
  data: {
    link: string  // Ссылка на оплату
  }
}

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

{
  "status": true,
  "statusCode": 200,
  "data": {
    "link": "https://sbp.fk.life/pay/1234567890"
  }
}

Ошибки

errorCode	message	Когда
46	INVALID_TOPUP_AMOUNT	Неверная сумма пополнения (вне диапазона 100-15000)

Минимальная сумма пополнения — 100 рублей, максимальная — 15000 рублей.

Содержание