API Reference
StatusDashboard

dispute.updated

wbhk
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.

Payload

Dispute.

const
enum
required

The type of event that occurred.

Allowed:
integer
required

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

date-time | null
required

Date dispute entered arbitration.

date-time
required

Timestamp of when first Dispute was reported.

date-time | null
required

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

string | null
required

End customer description of the reason for the dispute.

network_claim_ids
required

Unique identifiers for the dispute from the network.

date-time | null
required

Date that the dispute was submitted to the network.

string | null
required

Network reason code used to file the dispute.

date-time | null
required

Date dispute entered pre-arbitration.

string | null
required

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

string
enum
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.
date-time | null
required

Date the representment was received.

date-time | null
required

Date that the dispute was resolved.

string | null
required

Note by Dispute team on the case resolution.

string | null
enum
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.
string
enum
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.
uuid
required

Globally unique identifier.

uuid
required

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

Response
200

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

Updated 4 days ago

Did this page help you?
LoadingLoading…

Updated 4 days ago

Did this page help you?