Withdraw a dispute

​

Ends a dispute without a refund. Only the buyer can. The order closes as resolved_no_refund, which releases the funds to the seller. This cannot be undone.

Allowed while the order is dispute_open and no seller proposal is waiting for an answer (409 PROPOSAL_PENDING otherwise). An escalated dispute cannot be withdrawn: 409 INVALID_STATUS.

Returns the updated dispute, in the same shape as GET /v1/disputes/{orderNumber}.

Requires the disputes:write scope.

Path Parameters

  • The order the dispute belongs to, e.g. OR-ASNBC-1. Path parameter — not a query string.

Body

application/json
Empty object

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/disputes/{orderNumber}/withdraw
curl 'https://public-api.cardnexus.com/v1/disputes/{orderNumber}/withdraw' \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{}'
{
  "orderNumber": "OR-ASNBC-1",
  "yourRole": "buyer",
  "status": "dispute_open",
  "issues": [
    "wrong_condition"
  ],
  "description": "The corners are whitened, the listing said NM.",
  "evidenceCount": 3,
  "buyerPreference": "partial_refund",
  "currentProposal": {
    "id": "2026-06-18T10:15:00.000Z",
    "outcome": "partial_refund",
    "refund": {
      "amount": 4.5,
      "currency": "EUR"
    },
    "proposedAt": "2026-06-18T10:15:00.000Z",
    "declinedAt": null
  },
  "agreedOutcome": null,
  "escalatedAt": null,
  "escalatedBy": null,
  "verification": {
    "required": false,
    "requestedAt": null
  },
  "openedAt": "2026-06-17T16:40:00.000Z",
  "resolvedAt": null,
  "actions": [
    {
      "id": "decline-proposal",
      "method": "POST",
      "path": "/v1/disputes/OR-ASNBC-1/proposals/decline"
    },
    {
      "id": "escalate",
      "method": "POST",
      "path": "/v1/disputes/OR-ASNBC-1/escalate"
    }
  ],
  "webUrl": "https://cardnexus.com/orders/OR-ASNBC-1"
}