Open dispute for order

Запрос

Allowed only for completed order states (success or failed).

Behavior:

On create, order is moved to disputed.
If an open dispute already exists for the order (submitted / in_review), API returns that dispute.
Dispute is also sent to wallet-backend for synchronized processing.

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

apiKeyAuth

Путь

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

Order ID

Телоapplication/jsonобязательный

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

curl -i -X POST \
  'https://b2b-app.lumowallet.io/_mock/apis/orders/{id}/disputes' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "reason": "string"
  }'

Ответы

Dispute created

Телоapplication/json

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": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "externalOrderId": "string",
    "status": "created",
    "amountUsdt": 0,
    "amountRub": 0,
    "rate": 0,
    "nspkBrandName": "string",
    "createdAt": "2019-08-24T14:15:22Z"
  }
}