Sign in

v66

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

dispute.updated

Occurs when a dispute filed through the Chargebacks API (/v1/disputes) is created or updated.

This event is not emitted for Managed Disputes. Use dispute_transaction.created and dispute_transaction.updated instead.

postWebhookdispute.updated

Payload

event_type'dispute.updated' required

The type of event that occurred.

amountinteger required

Amount under dispute. May be different from the original transaction amount.

arbitration_datestring date-time nullable required

Date dispute entered arbitration.

createdstring date-time required

Timestamp of when first Dispute was reported.

customer_filed_datestring date-time nullable required

Date that the dispute was filed by the customer making the dispute.

customer_notestring nullable required

End customer description of the reason for the dispute.

network_claim_idsstring[] nullable required

Unique identifiers for the dispute from the network.

network_filed_datestring date-time nullable required

Date that the dispute was submitted to the network.

network_reason_codestring nullable required

Network reason code used to file the dispute.

prearbitration_datestring date-time nullable required

Date dispute entered pre-arbitration.

primary_claim_idstring nullable required

Unique identifier for the dispute from the network. If there are multiple, this will be the first claim id set by the network

reason'ATM_CASH_MISDISPENSE' | 'CANCELLED' | 'DUPLICATED' | 'FRAUD_CARD_NOT_PRESENT' | 'FRAUD_CARD_PRESENT' | 'FRAUD_OTHER' | 'GOODS_SERVICES_NOT_AS_DESCRIBED' | 'GOODS_SERVICES_NOT_RECEIVED' | 'INCORRECT_AMOUNT' | 'MISSING_AUTH' | 'OTHER' | 'PROCESSING_ERROR' | 'RECURRING_TRANSACTION_NOT_CANCELLED' | 'REFUND_NOT_PROCESSED' required

Dispute reason:

  • ATM_CASH_MISDISPENSE: ATM cash misdispense.
  • CANCELLED: Transaction was cancelled by the customer.
  • DUPLICATED: The transaction was a duplicate.
  • FRAUD_CARD_NOT_PRESENT: Fraudulent transaction, card not present.
  • FRAUD_CARD_PRESENT: Fraudulent transaction, card present.
  • FRAUD_OTHER: Fraudulent transaction, other types such as questionable merchant activity.
  • GOODS_SERVICES_NOT_AS_DESCRIBED: The goods or services were not as described.
  • GOODS_SERVICES_NOT_RECEIVED: The goods or services were not received.
  • INCORRECT_AMOUNT: The transaction amount was incorrect.
  • MISSING_AUTH: The transaction was missing authorization.
  • OTHER: Other reason.
  • PROCESSING_ERROR: Processing error.
  • REFUND_NOT_PROCESSED: The refund was not processed.
  • RECURRING_TRANSACTION_NOT_CANCELLED: The recurring transaction was not cancelled.
representment_datestring date-time nullable required

Date the representment was received.

resolution_datestring date-time nullable required

Date that the dispute was resolved.

resolution_notestring nullable required

Note by Dispute team on the case resolution.

resolution_reason'CASE_LOST' | 'NETWORK_REJECTED' | 'NO_DISPUTE_RIGHTS_3DS' | 'NO_DISPUTE_RIGHTS_BELOW_THRESHOLD' | 'NO_DISPUTE_RIGHTS_CONTACTLESS' | 'NO_DISPUTE_RIGHTS_HYBRID' | 'NO_DISPUTE_RIGHTS_MAX_CHARGEBACKS' | 'NO_DISPUTE_RIGHTS_OTHER' | 'PAST_FILING_DATE' | 'PREARBITRATION_REJECTED' | 'PROCESSOR_REJECTED_OTHER' | 'REFUNDED' | 'REFUNDED_AFTER_CHARGEBACK' | 'WITHDRAWN' | 'WON_ARBITRATION' | 'WON_FIRST_CHARGEBACK' | 'WON_PREARBITRATION' | 'null' nullable required

Reason for the dispute resolution:

  • CASE_LOST: This case was lost at final arbitration.
  • NETWORK_REJECTED: Network rejected.
  • NO_DISPUTE_RIGHTS_3DS: No dispute rights, 3DS.
  • NO_DISPUTE_RIGHTS_BELOW_THRESHOLD: No dispute rights, below threshold.
  • NO_DISPUTE_RIGHTS_CONTACTLESS: No dispute rights, contactless.
  • NO_DISPUTE_RIGHTS_HYBRID: No dispute rights, hybrid.
  • NO_DISPUTE_RIGHTS_MAX_CHARGEBACKS: No dispute rights, max chargebacks.
  • NO_DISPUTE_RIGHTS_OTHER: No dispute rights, other.
  • PAST_FILING_DATE: Past filing date.
  • PREARBITRATION_REJECTED: Prearbitration rejected.
  • PROCESSOR_REJECTED_OTHER: Processor rejected, other.
  • REFUNDED: Refunded.
  • REFUNDED_AFTER_CHARGEBACK: Refunded after chargeback.
  • WITHDRAWN: Withdrawn.
  • WON_ARBITRATION: Won arbitration.
  • WON_FIRST_CHARGEBACK: Won first chargeback.
  • WON_PREARBITRATION: Won prearbitration.
status'ARBITRATION' | 'CASE_CLOSED' | 'CASE_WON' | 'NEW' | 'PENDING_CUSTOMER' | 'PREARBITRATION' | 'REPRESENTMENT' | 'SUBMITTED' required

Status types:

  • NEW - New dispute case is opened.
  • PENDING_CUSTOMER - Lithic is waiting for customer to provide more information.
  • SUBMITTED - Dispute is submitted to the card network.
  • REPRESENTMENT - Case has entered second presentment.
  • PREARBITRATION - Case has entered prearbitration.
  • ARBITRATION - Case has entered arbitration.
  • CASE_WON - Case was won and credit will be issued.
  • CASE_CLOSED - Case was lost or withdrawn.
tokenstring uuid required

Globally unique identifier.

transaction_tokenstring uuid required

The transaction that is being disputed. A transaction can only be disputed once but may have multiple dispute cases.

Example payload

{
  "amount": 200,
  "arbitration_date": null,
  "created": "2023-07-19T18:39:34.768Z",
  "customer_filed_date": "2023-07-20T09:00:00Z",
  "customer_note": "I didn't receive the goods.",
  "network_claim_ids": [
    "CLAIM-001"
  ],
  "network_filed_date": "2023-07-21T11:00:00Z",
  "network_reason_code": "4808",
  "prearbitration_date": null,
  "primary_claim_id": "CLAIM-001",
  "reason": "GOODS_SERVICES_NOT_RECEIVED",
  "representment_date": null,
  "resolution_date": null,
  "resolution_note": null,
  "resolution_reason": null,
  "status": "SUBMITTED",
  "token": "b24230fa-181e-4b31-9a5c-276747e619a0",
  "transaction_token": "12345624-aa69-4cbc-a946-30d90181b621"
}

Response

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