JUjustifi
Disputes

Update a Dispute

Change a dispute's metadata.

patch/disputes/{id}

Request

Path parameters

idstring uuid required

Headers

Idempotency-Keystring uuid required

a string to identify your request (we recommend using a generated uuid, but you may use any unique string) see Idempotent Requests

Authorizationstring required

the access_token value returned from the JustiFi oauth/token endpoint (be sure to append Bearer before the token)

Request body

metadataobject

any useful information you'd like to store alongside this dispute; when you update metadata, any previous metadata will be overwritten

Response

Dispute update was successful

idstring uuid

the object id, also found in the data object

typestring

the object type, or array of objects

page_infounknown

Example response

{
  "id": "prefix_xyz (same as id of data object)",
  "type": "dispute",
  "data": {
    "id": "dp_xyz",
    "payment_id": "py_xyz",
    "account_id": "acc_xyz",
    "amount": 100,
    "currency": "usd",
    "reason": "fraudulent",
    "due_date": "2025-02-23",
    "status": "won",
    "metadata": {},
    "created_at": "2021-01-01T12:00:00Z",
    "updated_at": "2021-01-01T12:00:00Z",
    "dispute_response": {
      "service_date": "2024-10-31",
      "shipping_date": "2024-10-31"
    },
    "dispute_reversal": {
      "description": "Dispute was reversed",
      "created_at": "2021-01-01T12:00:00Z"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.