# Диспуты

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

## Когда открывать диспут

- Платёж отмечен как `success`, но получатель не получил средства
- Платёж отмечен как `failed`, но средства были списаны
- Некорректная сумма платежа
- Другие спорные ситуации


## Ограничения

Диспут можно открыть только для ордеров со статусом:

- `success`
- `failed`


Нельзя открыть диспут для:

- `in_progress` — дождитесь завершения
- `expired_*` — средства не были списаны
- `disputed` — диспут уже открыт


## Создание диспута


```bash
curl -X POST 'https://b2b.lumowallet.io/orders/{orderId}/disputes' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "Платёж отображается как успешный, но магазин не получил оплату"
  }'
```

Ответ:


```json
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "orderId": "660e8400-e29b-41d4-a716-446655440001",
  "status": "submitted",
  "resolution": null,
  "reason": "Платёж отображается как успешный, но магазин не получил оплату",
  "adminComment": null,
  "resolvedBy": null,
  "refundAmount": null,
  "resolvedAt": null,
  "createdAt": "2026-03-10T12:00:00Z",
  "updatedAt": "2026-03-10T12:00:00Z"
}
```

После создания диспута:

- Ордер переходит в статус `disputed`
- Диспут отправляется на рассмотрение


## Статусы диспута

| Статус | Описание |
|  --- | --- |
| `submitted` | Диспут создан, ожидает рассмотрения |
| `in_review` | Диспут на рассмотрении |
| `resolved` | Диспут разрешён |
| `rejected` | Диспут отклонён |


## Резолюции

При разрешении диспута устанавливается `resolution`:

| Резолюция | Описание |
|  --- | --- |
| `refund` | Полный возврат средств |
| `confirm` | Платёж подтверждён, возврата нет |
| `partial_refund` | Частичный возврат |


Для `partial_refund` поле `refundAmount` содержит сумму возврата.

## Список диспутов


```bash
curl -X GET 'https://b2b.lumowallet.io/disputes' \
  -H 'X-API-Key: YOUR_API_KEY'
```

Ответ:


```json
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "orderId": "660e8400-e29b-41d4-a716-446655440001",
    "status": "resolved",
    "resolution": "refund",
    "reason": "Магазин не получил оплату",
    "adminComment": "Подтверждено: платёж не дошёл до получателя",
    "resolvedBy": "admin@lumo.io",
    "refundAmount": null,
    "resolvedAt": "2026-03-10T14:00:00Z",
    "createdAt": "2026-03-10T12:00:00Z",
    "updatedAt": "2026-03-10T14:00:00Z"
  }
]
```

## Идемпотентность

Если диспут уже открыт для ордера:

- API вернёт существующий диспут
- Новый диспут не создаётся
- Это позволяет безопасно повторять запрос


## Процесс рассмотрения

1. **submitted** — диспут создан
2. **in_review** — администратор изучает ситуацию
3. **resolved/rejected** — решение принято


Время рассмотрения: обычно 1-3 рабочих дня.

## Возврат средств

При резолюции `refund` или `partial_refund`:

- Средства возвращаются на баланс компании
- Ордер остаётся в статусе `disputed`
- `refundAmount` указывает сумму возврата


## Рекомендации

1. **Описывайте подробно** — чем больше деталей в `reason`, тем быстрее решение
2. **Прикладывайте доказательства** — скриншоты, логи (через поддержку)
3. **Не дублируйте** — один диспут на ордер
4. **Отслеживайте статус** — проверяйте список диспутов


## Поддержка

Для ускорения рассмотрения свяжитесь с поддержкой:

- Telegram: [@lumo_support_bot](https://t.me/lumo_support_bot)
- Укажите ID диспута и детали ситуации