Реферальная система

Методы реферальной программы: история начислений и выводов, список банков СБП.

Обзор

Модуль реферальной программы: получение объединённой истории начислений и выводов, а также списка банков для вывода через СБП.

Через API-ключ доступны только методы чтения (GET). Сам вывод средств (POST /profile/referral/withdraw/sbp и /card) выполняется только в приложении или личном кабинете и недоступен через API-ключ — такой запрос вернёт 401 ACCESS_DENIED.

GET /profile/referral

Получить данные реферальной программы (объединённая история начислений и выводов).

Rate Limit: глобальный (60 req/min)

Query Parameters

Parameter	Type	Required	Description
`limit`	number	Нет	По умолчанию 100 (1-1000)
`offset`	number	Нет	Смещение для пагинации (>= 0, по умолчанию 0)

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

curl -X GET "https://api.stealthsurf.net/profile/referral?limit=10&offset=0" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY"

Ответ

{
  status: true,
  statusCode: 200,
  data: Array<{
    amount: number          // В рублях
    method?: string
    account?: string
    status?: string
    created_at: number
    email?: string
  }>
}

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

{
  "status": true,
  "statusCode": 200,
  "data": [
    {
      "email": "u***r@test.com",
      "amount": 50,
      "created_at": 1716153600
    },
    {
      "amount": 1000,
      "method": "sbp",
      "account": "30|Sberbank|+79991234567",
      "status": "created",
      "created_at": 1716150000
    }
  ]
}

Список объединяет два типа записей: начисления (email — маскированный адрес или Пользователь #<id>, и amount) и выводы (amount, method, account, status).

GET /profile/referral/withdraw/sbp-bank-list

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

Rate Limit: 5 req / 5 sec

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

curl -X GET "https://api.stealthsurf.net/profile/referral/withdraw/sbp-bank-list" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY"

Ответ

{
  status: true,
  statusCode: 200,
  data: Array<{
    id: string
    name: string
  }>
}

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

{
  "status": true,
  "statusCode": 200,
  "data": [
    { "id": "100000000111", "name": "Сбербанк" },
    { "id": "100000000004", "name": "Тинькофф" },
    { "id": "100000000015", "name": "Альфа-Банк" }
  ]
}

Реферальная система

Содержание