Диспуты

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

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

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

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

Ограничения

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

• success
• failed

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

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

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

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

Ответ:

{
  "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
• Диспут отправляется на рассмотрение

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

Резолюции

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

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

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

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

Ответ:

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "orderId": "660e8400-e29b-41d4-a716-446655440001",
    "status": "resolved",
    "resolution": "refund",
    "reason": "Магазин не получил оплату",
    "adminComment": "Подтверждено: платёж не дошёл до получателя",
    "resolvedBy": "[email protected]",
    "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
• Укажите ID диспута и детали ситуации