List company disputes

Запрос

Returns company dispute history (newest first).

Resolution fields:

resolvedAt is set when dispute is resolved.
resolution is set on resolve (confirm, refund, partial_refund).
refundAmount is set for refund (the full order amount) and for partial_refund (the part returned); it is null for confirm. It states how much of the order was reversed — not how much reached your balance. When the funds had not been debited yet, the resolution merely releases the hold. Check GET /wallets/balance-history with referenceId = orderId for the real movement.

The outcome lives in resolution, not in status: a dispute you won and one you lost both end up as status: resolved. refund / partial_refund mean the payment was reversed (the order becomes failed); confirm means the dispute was turned down and the payment stands (the order goes back to success).

Each item embeds the order it belongs to, so no second call is needed.

Disputes can be resolved by admin flow or automatically from wallet callback final status.

Безопасность

apiKeyAuth

Запрос

searchstring

Find a dispute by the order it belongs to — same matching as GET /orders: your externalOrderId (substring is enough) or our order id.

statusstring(DisputeStatus)

Enum:"submitted""in_review""resolved""rejected"

resolutionstring(DisputeResolution)

Filter by outcome.

Enum:"refund""confirm""partial_refund"

limitinteger, [ 1 .. 200 ]

Omit to get the full history in one array (the historical behaviour). When set, the total count comes back in the X-Total-Count header.

По умолчанию:50

offsetinteger, >= 0

По умолчанию:0

curl -i -X GET \
  'https://b2b-app.lumowallet.io/_mock/apis/disputes?search=string&status=submitted&resolution=refund&limit=50&offset=0' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Ответы

Disputes list

Заголовки

X-Total-Countinteger

Total matching disputes; present when limit is used.

Телоapplication/json

Array [

idstring, (uuid)обязательный

orderIdstring, (uuid)обязательный

statusstring(DisputeStatus)обязательный

Enum:"submitted""in_review""resolved""rejected"

resolutionDisputeResolution (string) or null

One of:

The outcome. Set when the dispute is resolved — read this rather than status, which only says whether it has been looked at. refund / partial_refund = payment reversed (order → failed), confirm = dispute turned down, payment stands (order → success).

string(DisputeResolution)

Enum:"refund""confirm""partial_refund"

reasonstringобязательный

adminCommentstring or null

resolvedBystring or null

refundAmountnumber or null

How much of the order was reversed: the full order amount for refund, the returned part for partial_refund, null for confirm. This is not the amount credited to your balance — if the funds were still on hold, resolving only releases the hold. See GET /wallets/balance-history (referenceId = orderId).

resolvedAtstring or null, (date-time)

Resolution timestamp (admin or wallet callback sync).

createdAtstring, (date-time)обязательный

updatedAtstring, (date-time)обязательный

orderobject

The order this dispute belongs to, embedded so you don't need a second call. Additional internal fields may be present in the payload; only the ones listed here are part of the contract.

]

Response

[
  {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
    "status": "submitted",
    "resolution": "refund",
    "reason": "string",
    "adminComment": "string",
    "resolvedBy": "string",
    "refundAmount": 0,
    "resolvedAt": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "order": { … }
  }
]