Dispute Structure

Properties

dispute_token

• Type: uuid
• Required: Yes

amount

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

arbitration_date

• Type: date-time | null
• Required: Yes

created

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

customer_filed_date

• Type: date-time | null
• Required: Yes

customer_note

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

network_claim_ids

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

network_filed_date

• Type: date-time | null
• Required: Yes

network_reason_code

• Type: string | null
• Required: Yes

prearbitration_date

• Type: date-time | null
• Required: Yes

primary_claim_id

• Type: string | null
• Required: Yes
• Unique identifier for the dispute from the network. If there are multiple, this will be the first claim id set by the network.

reason

• Type: string (enum)
• Required: Yes
• 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_date

• Type: date-time | null
• Required: Yes

resolution_date

• Type: date-time | null
• Required: Yes

resolution_note

• Type: string | null
• Required: Yes

resolution_reason

• Type: string (enum)
• Required: Yes
• 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

• Type: string (enum)
• Required: Yes
• 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.

token

• Type: uuid
• Required: Yes

transaction_token

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