---
title: "dispute_transaction.updated"
method: POST
path: "dispute_transaction.updated"
tags: ["Event Types"]
---

# dispute_transaction.updated

`POST dispute_transaction.updated` (webhook)

Occurs when a dispute transaction for a Managed Disputes case is updated.

## Payload

- object — The Dispute object tracks the progression of a dispute throughout its lifecycle.
  - `event_type` 'dispute_transaction.updated', required — The type of event that occurred.
  - `case_id` string, nullable, required — Identifier assigned by the network for this dispute.
  - `token` string, uuid, required — Token assigned by Lithic for the dispute, in UUID format.
  - `card_token` string, uuid, required — Token for the card used in the dispute, in UUID format.
  - `account_token` string, uuid, required — Token for the account associated with the dispute, in UUID format.
  - `network` 'VISA' | 'MASTERCARD', required — Card network handling the dispute.
  - `currency` string, required — Three-letter ISO 4217 currency code.
  - `created` string, date-time, required — When the dispute was created.
  - `updated` string, date-time, required — When the dispute was last updated.
  - `merchant` Merchant, required
    - `acceptor_id` string, required — Unique alphanumeric identifier for the payment card acceptor (merchant).
    - `acquiring_institution_id` string, required — Unique numeric identifier of the acquiring institution.
    - `city` string, required — City of card acceptor. Note that in many cases, particularly in card-not-present transactions, merchants may send through a phone number or URL in this field.
    - `country` string, required — Country or entity of card acceptor. Possible values are: (1) all ISO 3166-1 alpha-3 country codes, (2) QZZ for Kosovo, and (3) ANT for Netherlands Antilles.
    - `descriptor` string, required — Short description of card acceptor.
    - `mcc` string, required — Merchant category code (MCC). A four-digit number listed in ISO 18245. An MCC is used to classify a business by the types of goods or services it provides.
    - `state` string, required — Geographic state of card acceptor.
  - `transaction_series` TransactionSeries, required — Contains identifiers for the transaction and specific event within being disputed; null if no transaction can be identified
    - `type` 'DISPUTE', required — The type of transaction series associating the dispute and the original transaction. Always set to DISPUTE
    - `related_transaction_token` string, uuid, required — Token of the original transaction being disputed, in UUID format
    - `related_transaction_event_token` string, uuid, nullable, required — Token of the specific event in the original transaction being disputed, in UUID format; null if no event can be identified
  - `liability_allocation` LiabilityAllocation, required — Current breakdown of how liability is allocated for the disputed amount
    - `original_amount` integer, required — The initial amount disputed
    - `recovered_amount` integer, required — The amount that has been recovered from the merchant through the dispute process
    - `written_off_amount` integer, required — The amount the issuer has chosen to write off
    - `denied_amount` integer, required — The amount that has been denied to the cardholder
    - `remaining_amount` integer, required — Any disputed amount that is still outstanding, i.e. has not been recovered, written off, or denied
  - `status` 'OPEN' | 'CLOSED' | 'null', nullable, required — Current status of the dispute.
  - `disposition` 'WON' | 'LOST' | 'PARTIALLY_WON' | 'WITHDRAWN' | 'DENIED' | 'null', nullable, required — Dispute resolution outcome
  - `events` Event[], required — Chronological list of events that have occurred in the dispute lifecycle
    - `token` string, uuid, required — Unique identifier for the event, in UUID format
    - `type` 'WORKFLOW' | 'FINANCIAL' | 'CARDHOLDER_LIABILITY', required — Type of event
    - `created` string, date-time, required — When the event occurred
    - `data` union, required — Details specific to the event type
      - WorkflowEventData — Details specific to workflow events
        - `type` 'WORKFLOW', required — Event type discriminator
        - `stage` 'CLAIM', required — Current stage of the dispute workflow
        - `action` 'OPENED' | 'CLOSED' | 'REOPENED', required — Action taken in this stage
        - `reason` string, nullable, required — Reason for the action
        - `amount` integer, nullable, required — Amount in minor units
        - `disposition` 'WON' | 'LOST' | 'PARTIALLY_WON' | 'WITHDRAWN' | 'DENIED' | 'null', nullable, required — Dispute resolution outcome
      - FinancialEventData — Details specific to financial events
        - `type` 'FINANCIAL', required — Event type discriminator
        - `stage` 'CHARGEBACK' | 'REPRESENTMENT' | 'PREARBITRATION' | 'ARBITRATION' | 'COLLABORATION', required — Stage at which the financial event occurred
        - `amount` integer, required — Amount in minor units
        - `polarity` 'CREDIT' | 'DEBIT', required — Direction of funds flow
      - CardholderLiabilityEventData — Details specific to cardholder liability events
        - `type` 'CARDHOLDER_LIABILITY', required — Event type discriminator
        - `action` 'PROVISIONAL_CREDIT_GRANTED' | 'PROVISIONAL_CREDIT_REVERSED' | 'WRITTEN_OFF', required — Action taken regarding cardholder liability
        - `amount` integer, required — Amount in minor units
        - `reason` string, required — Reason for the action

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/versions/53ab5d4e2adb/schema)