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

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

Обзор

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

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

GET /profile/referral

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

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

Query Parameters

Parameter	Type	Required	Description
`limit`	number	Нет	Количество записей, от 1 до 1000. По умолчанию 100
`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          // Сумма операции в рублях
    created_at: number      // Дата операции, Unix timestamp
    email?: string          // Маскированный email реферала, только для пополнений
    method?: string         // Способ вывода, только для выводов
    account?: string        // Счёт получателя, только для выводов
    status?: 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, amount, created_at) и выводы средств (amount, method, account, status, created_at). Email реферала маскируется, а если он отсутствует — подставляется строка вида Пользователь #<id>.

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": "Альфа-Банк" }
  ]
}

Список отдаётся из кеша. Если кеш пуст, метод вернёт пустой массив — в этом случае повторите запрос позже.

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

Содержание