v66

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-042174421.1 MB

Event Types

dispute_transaction.created

Occurs when a new dispute transaction is created for a Managed Disputes case.

postWebhookdispute_transaction.created

Payload

event_type'dispute_transaction.created' required

The type of event that occurred.

case_idstring nullable required

Identifier assigned by the network for this dispute.

tokenstring uuid required

Token assigned by Lithic for the dispute, in UUID format.

card_tokenstring uuid required

Token for the card used in the dispute, in UUID format.

account_tokenstring uuid required

Token for the account associated with the dispute, in UUID format.

network'VISA' | 'MASTERCARD' required

Card network handling the dispute.

currencystring required

Three-letter ISO 4217 currency code.

createdstring date-time required

When the dispute was created.

updatedstring date-time required

When the dispute was last updated.

status'OPEN' | 'CLOSED' | 'null' nullable required

Current status of the dispute.

Dispute resolution outcome

Example payload

{
  "event_type": "dispute_transaction.created",
  "currency": "USD",
  "merchant": {
    "acceptor_id": "333301802529120",
    "acquiring_institution_id": "191231",
    "city": "NEW YORK",
    "country": "USA",
    "descriptor": "COFFEE SHOP",
    "mcc": "5812",
    "state": "NY"
  }
}

Response

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