ДЕЙСТВУЮЩИЙ КОНТРАКТ

Реквизиты¶

Каждый реквизит принадлежит одному трейдеру и одной фиатной валюте. Валюту существующего реквизита изменить нельзя.

Создать реквизит¶

POST /api/v1/requisite/
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "tag": "uzs-card-0042",
  "currency_code": "UZS",
  "payment_type": "C2C",
  "bank": 17,
  "account_number": "8600 1234 5678 9012",
  "fio": "CARD HOLDER",
  "total_limit": "50000000",
  "min_income": "10000",
  "max_income": "5000000",
  "instant_active_orders": 1,
  "daily_limit_enabled": true,
  "daily_total_limit": "15000000",
  "monthly_limit_enabled": true,
  "monthly_total_limit": "100000000"
}

Поля создания¶

Поле	Обязательность	Описание
`tag`	Да	Глобально уникальная метка, до 32 символов
`currency_code`	Передавайте всегда	Код из `/currencies/?operation=requisite`
`payment_type`	Да	`C2C`, `SBP`, `TRANSFER` или `C2C/SBP`
`bank`	Да	ID банка для валюты и способа оплаты
`account_number`	Зависит от типа	Карта для `C2C`, счёт для `TRANSFER`
`phone_number`	Для телефонного `SBP`	Номер телефона
`account_number_second`	Нет	Второй 20-значный счёт
`fio`	Нет	Имя получателя
`description`	Нет	Внутреннее описание
`total_limit`	Да	Общий лимит входящих платежей
`min_income`, `max_income`	Для работы	Диапазон одной заявки
`instant_active_orders`	Для работы	Максимум одновременных заявок
`daily_limit_enabled`, `daily_total_limit`	Нет	Дневной лимит
`monthly_limit_enabled`, `monthly_total_limit`	Нет	Месячный лимит
`successful_deposit_limit`	Нет	Лимит успешных пополнений за сутки; `0` — без лимита

Созданный реквизит всегда сохраняется выключенным. Включите его отдельным запросом после проверки ответа.

Форматы номеров

C2C принимает 16 цифр в формате 1111 1111 1111 1111. TRANSFER принимает 20 цифр. Для SBP передайте телефон или карту.

Получить список¶

GET /api/v1/requisite/?currency_code=UZS&active=true&payment_type=C2C&page=1&page_size=100
Authorization: Bearer <access_token>

Доступные фильтры: currency_code, active, payment_type, search по полю tag, page, page_size. Максимальный page_size — 100.

Ответ содержит count, active_count, inactive_count, total_count и results. Для проверки нормализованной валюты и номера после создания перечитайте объект через GET /api/v1/requisite/{id}/.

Изменить и включить¶

PATCH /api/v1/requisite/42/
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "active": true
}

При частичном изменении передавайте только изменяемые поля. Не передавайте currency_code: валюта после создания неизменяема. Включение возможно, когда трейдер активен, его заявки включены, баланс положительный, а max_income больше нуля и не превышает доступные лимиты.

Массово включить или выключить¶

PATCH /api/v1/requisite/toggle_all_requisites/
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "active": false,
  "currency_code": "UZS",
  "ids": [42, 43]
}

currency_code и ids необязательны. Без них действие применяется ко всем видимым реквизитам трейдера. При включении обрабатываются только реквизиты с max_income > 0.

Удалить¶

DELETE /api/v1/requisite/42/
Authorization: Bearer <access_token>

Удаление мягкое: реквизит выключается, скрывается из списка и больше не участвует в маршрутизации.