dispute.updated

Dispute

event_type

• Type: const
• Enum: dispute.updated
• Required: Yes
• Description: The type of event that occurred.

amount

• Type: integer
• Required: Yes
• Description: Amount under dispute. May be different from the original transaction amount.

arbitration_date

• Type: date-time | null
• Required: Yes
• Description: Date dispute entered arbitration.

created

• Type: date-time
• Required: Yes
• Description: Timestamp of when first Dispute was reported.

customer_filed_date

• Type: date-time | null
• Required: Yes
• Description: Date that the dispute was filed by the customer making the dispute.

customer_note

• Type: string | null
• Required: Yes
• Description: End customer description of the reason for the dispute.

network_claim_ids

• Type: array of strings
• Required: Yes
• Description: Unique identifiers for the dispute from the network.

network_filed_date

• Type: date-time | null
• Required: Yes
• Description: Date that the dispute was submitted to the network.

network_reason_code

• Type: string | null
• Required: Yes
• Description: Network reason code used to file the dispute.

prearbitration_date

• Type: date-time | null
• Required: Yes
• Description: Date dispute entered pre-arbitration.

primary_claim_id

• Type: string | null
• Required: Yes
• Description: Unique identifier for the dispute from the network.

reason

• Type: string
• Enum:
  • 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_date

• Type: date-time | null
• Required: Yes
• Description: Date the representment was received.

resolution_date

• Type: date-time | null
• Required: Yes
• Description: Date that the dispute was resolved.

resolution_note

• Type: string | null
• Required: Yes
• Description: Note by Dispute team on the case resolution.

resolution_reason

• Type: string
• Enum:
  • 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

• Type: string
• Enum:
  • 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.

token

• Type: uuid
• Required: Yes
• Description: Globally unique identifier.

transaction_token

• Type: uuid
• Required: Yes
• Description: The transaction that is being disputed. A transaction can only be disputed once but may have multiple dispute cases.

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