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

Заявки¶

Трейдер получает только назначенные ему заявки. Входящих уведомлений для трейдера нет: новые заявки и диспуты нужно регулярно запрашивать через API.

Получить заявки¶

GET /api/v1/orders/?status__in=BN,IP,UR,ID&page=1&page_size=100
Authorization: Bearer <access_token>

Доступные параметры: status, status__in, id, page, page_size. Неизвестные параметры приводят к ошибке 400.

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "71f25851-28d3-47eb-8770-51f717f5821e",
      "status": "BN",
      "requisite": {
        "tag": "uzs-card-0042 8600 1234 5678 9012",
        "payment_type": "C2C",
        "account_number": "8600 1234 5678 9012"
      },
      "expected_income": "100000.000000",
      "temp_income": "0.000000",
      "real_income": "0.000000",
      "currency_code_to": "UZS",
      "create_dt": "2026-09-04T10:00:00+03:00",
      "time_left": 24,
      "has_files": false,
      "integration_order": false
    }
  ]
}

Одна заявка доступна по GET /api/v1/orders/{order_id}/.

Статусы трейдера¶

Код	Значение
`BN`	Новая заявка
`IP`	Заявка взята в работу
`UR`	Передана фактическая сумма для перерасчёта
`ID`	Открыт диспут
`SF`	Успешно завершена
`FR`	Диспут принят с перерасчётом
`CR`	Диспут отклонён с перерасчётом
`TO`	Истёк срок обработки
`CANCELED`	Заявка отклонена

Дополнительно API может вернуть AA, AAD или NF. Не заменяйте коды локальными числами и допускайте появление уже существующих кодов из ответа API.

Полная расшифровка, группы состояний и схема жизненного цикла приведены в справочнике статусов.

Изменить статус¶

Для перехода без изменения суммы:

PATCH /api/v1/users/change_order_status/71f25851-28d3-47eb-8770-51f717f5821e/
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "status": "SF"
}

Основные команды:

BN → SF — подтвердить полную ожидаемую сумму;
BN → CANCELED — отклонить заявку;
BN → IP — взять заявку в работу;
ID → FR — принять диспут;
ID → CR — отклонить диспут.

Для завершения с другой фактической суммой:

PATCH /api/v1/users/change_order_data/71f25851-28d3-47eb-8770-51f717f5821e/
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "status": "UR",
  "temp_income": "97500"
}

Разрешённость перехода проверяет сервер. Не пытайтесь задавать произвольные статусы или менять сумму отдельным запросом без соответствующего перехода.

Время обработки и повторы¶

time_left возвращается в секундах. Для BN и IP изменение блокируется, если осталось не более 8 секунд: заявка уже передаётся фоновой задаче.

HTTP	Что произошло	Что делать
`200`	Переход применён	Сохранить полученное состояние
`400`	Переход, данные или остаток времени недопустимы	Перечитать заявку
`404`	Заявка не назначена этому трейдеру или не найдена	Прекратить обработку
`409`	По заявке уже выполняется другая команда	Подождать и перечитать заявку
`504`	API не дождался фоновой обработки	Перечитать заявку до любого повтора

После 409, 504 или сетевого тайм-аута результат неизвестен. Сначала выполните GET /api/v1/orders/{order_id}/; повторяйте команду только если состояние не изменилось и переход всё ещё разрешён.