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

Методы для работы с реферальной системой: история начислений, вывод средств.

Обзор

Модуль для работы с реферальной системой: получение истории начислений и вывод средств.

GET /profile/referral

Получить историю реферальных начислений.

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

Query Parameters

Parameter	Type	Required	Description
`limit`	number	Нет	Максимум 100
`offset`	number	Нет	Смещение для пагинации

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

curl -X GET "https://api.stealthsurf.app/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
  }>
}

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

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

Rate Limit: 5 req / 5 sec

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

curl -X GET "https://api.stealthsurf.app/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": "Альфа-Банк" }
  ]
}

POST /profile/referral/withdraw/sbp

Вывести средства через СБП.

Rate Limit: 1 req / 3 sec

Request Body

Field	Type	Required	Description
`bank_id`	string	Да	ID банка (1-32 символа)
`amount`	number	Да	Сумма в рублях (1000-75000)
`phone_number`	string	Да	Телефон в формате +7XXXXXXXXXX

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

curl -X POST "https://api.stealthsurf.app/profile/referral/withdraw/sbp" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY" \
  -H "Content-Type: application/json" \
  -d '{
    "bank_id": "100000000111",
    "amount": 50000,
    "phone_number": "+79001234567"
  }'

Ответ

{
  status: true,
  statusCode: 201,
  data: {
    id: number
    created_at: number
  }
}

Минимальная сумма вывода — 1000 рублей, максимальная — 75000 рублей.

POST /profile/referral/withdraw/card

Вывести средства на карту.

Rate Limit: 1 req / 3 sec

Request Body

Field	Type	Required	Description
`amount`	number	Да	Сумма в рублях (1000-75000)
`card_number`	string	Да	Номер карты (проверка по Luhn)

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

curl -X POST "https://api.stealthsurf.app/profile/referral/withdraw/card" \
  -H "Authorization: Bearer stlth_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "card_number": "4111111111111111"
  }'

Ответ

{
  status: true,
  statusCode: 201,
  data: {
    id: number
    created_at: number
  }
}

Номер карты проверяется по алгоритму Luhn. Убедитесь, что номер введён корректно.

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

Содержание