Аккаунт

🔗 Эндпоинт v2: Информация об аккаунте

GET /api/v2/accounts/me

Позволяет получить базовую информацию о текущем аккаунте мерчанта.

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

curl --location -g '{{url}}/api/v2/accounts/me' \
--header 'Authorization: Token {{token}}'

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

{
  "id": 703,
  "username": "TestMerchLK",
  "role": "merchant",
  "balance": 14339.02,
  "min_balance": 0.0,
  "rate": 0.0,
  "course": 82.34,
  "course_with_rate": 82.34,
  "is_active": true,
  "created_at": "2025-05-15T11:05:11.534736+03:00",
  "updated_at": "2025-10-23T10:38:25.971125+03:00",
  "usdt_balance": 14339.02,
  "min_usdt_balance": 0.0,
  "is_tour_finished": false,
  "is_transaction_type_editable": false,
  "is_allowed_payout_service": true,
  "is_swap_allowed": false,
  "withdraw_fix_commission": "2.00",
  "geo": 1,
  "rates": {
    "base_rate": 15.0,
    "night_shift_rate": 0.0,
    "law_range_payments": 0.0,
    "sbp_rate": 0.0,
    "mobile_commerce_rate": 0.0,
    "card_rate": 0.0,
    "account_number_rate": 0.0,
    "qr_code_rate": 0.0,
    "to_yandex_tips_rate": 0.0,
    "transgran_number_rate": -2.5,
    "transgran_sbp_rate": -2.5,
    "donation_url_rate": 0.0,
    "nspk_rate": 0.0,
    "quasi_ecom_rate": 0.0
  },
  "is_fiat_balance": false,
  "is_course_visible": true
}

Поле	Тип	Описание
id	integer	Уникальный идентификатор
username	string	Логин аккаунта
role	string	Роль пользователя в системе.
balance	float	Текущий баланс аккаунта.
min_balance	float	Минимальный баланс,
rate	float	Общая комиссионная ставка в процентах.
course	float	Курс обмена.
course_with_rate	float	Курс с учетом ставки.
is_active	boolean	Статус активности аккаунта.
created_at	string (ISO 8601)	Дата и время создания аккаунта.
updated_at	string (ISO 8601)	Дата и время последнего обновления аккаунта.
usdt_balance	float	Текущий баланс в USDT.
min_usdt_balance	float	Минимальный USDT баланс, который должен быть на счете.
is_tour_finished	boolean	Флаг, указывающий, завершен ли ознакомительный тур по платформе.
is_transaction_type_editable	boolean	Флаг, разрешено ли редактировать тип транзакции.
is_allowed_payout_service	boolean	Флаг, разрешен ли сервис выплат.
is_swap_allowed	boolean	Флаг, Разрешено ли выводить средства через обмен.
withdraw_fix_commission	string	Фиксированная комиссия за вывод средств.
geo	string/null	Географическая привязка аккаунта .
rates	object/null	Детализированные ставки.
is_fiat_balance	boolean	Флаг, используется ли фиатный баланс .
is_course_visible	boolean	Флаг, отображается ли курс.

---

Эндпоинт v4: Расширенная информация об аккаунте

GET /api/v4/accounts/me

Ключевые изменения в API v4:

• Убран course_with_rate и rate.
• Добавлен объект rates с детализацией по методам и условиям.
• Поддержка нескольких балансов в разных валютах.

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

curl -X GET '{{url}}/api/v4/accounts/me' \
  -H 'Authorization: Token {{token}}'

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

{
  "id": 72,
  "username": "merchant",
  "role": "merchant",
  "rates": {
    "base_rate": 6.25,
    "night_shift_rate": 2.0,
    "law_range_payments": 10.0,
    "sbp_rate": 2.0,
    "card_rate": 5.0,
    "mobile_commerce_rate": 0.0,
    "account_number_rate": 2.0,
    "qr_code_rate": 0.0,
    "to_yandex_tips_rate": 0.0,
    "transgran_number_rate": 0.0,
    "transgran_sbp_rate": 0.0,
    "donation_url_rate": 0.0,
    "nspk_rate": 0.0,
    "quasi_ecom_rate": 0.0
  },
  "is_transaction_type_editable": true,
  "balances": [
    {
      "currency": "Манат",
      "code": "AZN",
      "balance": 0.00,
      "geo": "Азербайджан",
      "course": 1.76
    },
    {
      "currency": "USDT",
      "code": "USDT",
      "balance": 0.00,
      "geo": "Азербайджан",
      "course": 1.76
    }
  ],
  "is_active": true,
  "created_at": "2024-03-27T13:15:19.438687+03:00",
  "updated_at": "2025-04-14T11:22:24.376139+03:00"
}

Расшифровка rates

Поле	Описание
base_rate	Базовая ставка
night_shift_rate	Надбавка за ночное время (01:00–08:00 по МСК)
law_range_payments	Доп. ставка при чеке 100–999 ₽ и geo
*_rate	Ставки по методам: card_rate, sbp_rate, nspk_rate и т.д.

Пример расчета final_rate:

Для платежа 500 ₽ в 02:30 по карте в России:

accumulated_rate = 6.25 (base_rate)
                 + 2.0  (night_shift_rate)
                 + 10.0 (law_range_payments)
                 + 5.0  (card_rate)
               = 23.25%