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