Dispute

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/dispute-v1",
  "title": "Dispute",
  "description": "Dispute.",
  "properties": {
    "amount": {
      "description": "Amount under dispute. May be different from the original transaction amount.",
      "type": "integer"
    },
    "arbitration_date": {
      "description": "Date dispute entered arbitration.",
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "created": {
      "description": "Timestamp of when first Dispute was reported.",
      "format": "date-time",
      "type": "string"
    },
    "customer_filed_date": {
      "description": "Date that the dispute was filed by the customer making the dispute.",
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "customer_note": {
      "description": "End customer description of the reason for the dispute.",
      "maxLength": 10000,
      "type": [
        "string",
        "null"
      ]
    },
    "network_claim_ids": {
      "description": "Unique identifiers for the dispute from the network.",
      "oneOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "network_filed_date": {
      "description": "Date that the dispute was submitted to the network.",
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "network_reason_code": {
      "description": "Network reason code used to file the dispute.",
      "type": [
        "string",
        "null"
      ]
    },
    "prearbitration_date": {
      "description": "Date dispute entered pre-arbitration.",
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "primary_claim_id": {
      "description": "Unique identifier for the dispute from the network. If there are multiple, this will be the first claim id set by the network",
      "type": [
        "string",
        "null"
      ]
    },
    "reason": {
      "description": "Dispute reason:\n* `ATM_CASH_MISDISPENSE`: ATM cash misdispense.\n* `CANCELLED`: Transaction was cancelled by the customer.\n* `DUPLICATED`: The transaction was a duplicate.\n* `FRAUD_CARD_NOT_PRESENT`: Fraudulent transaction, card not present.\n* `FRAUD_CARD_PRESENT`: Fraudulent transaction, card present.\n* `FRAUD_OTHER`: Fraudulent transaction, other types such as questionable merchant activity.\n* `GOODS_SERVICES_NOT_AS_DESCRIBED`: The goods or services were not as described.\n* `GOODS_SERVICES_NOT_RECEIVED`: The goods or services were not received.\n* `INCORRECT_AMOUNT`: The transaction amount was incorrect.\n* `MISSING_AUTH`: The transaction was missing authorization.\n* `OTHER`: Other reason.\n* `PROCESSING_ERROR`: Processing error.\n* `REFUND_NOT_PROCESSED`: The refund was not processed.\n* `RECURRING_TRANSACTION_NOT_CANCELLED`: The recurring transaction was not cancelled.\n",
      "enum": [
        "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"
      ],
      "type": "string"
    },
    "representment_date": {
      "description": "Date the representment was received.",
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "resolution_date": {
      "description": "Date that the dispute was resolved.",
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "resolution_note": {
      "description": "Note by Dispute team on the case resolution.",
      "maxLength": 10000,
      "type": [
        "string",
        "null"
      ]
    },
    "resolution_reason": {
      "description": "Reason for the dispute resolution:\n* `CASE_LOST`: This case was lost at final arbitration.\n* `NETWORK_REJECTED`: Network rejected.\n* `NO_DISPUTE_RIGHTS_3DS`: No dispute rights, 3DS.\n* `NO_DISPUTE_RIGHTS_BELOW_THRESHOLD`: No dispute rights, below threshold.\n* `NO_DISPUTE_RIGHTS_CONTACTLESS`: No dispute rights, contactless.\n* `NO_DISPUTE_RIGHTS_HYBRID`: No dispute rights, hybrid.\n* `NO_DISPUTE_RIGHTS_MAX_CHARGEBACKS`: No dispute rights, max chargebacks.\n* `NO_DISPUTE_RIGHTS_OTHER`: No dispute rights, other.\n* `PAST_FILING_DATE`: Past filing date.\n* `PREARBITRATION_REJECTED`: Prearbitration rejected.\n* `PROCESSOR_REJECTED_OTHER`: Processor rejected, other.\n* `REFUNDED`: Refunded.\n* `REFUNDED_AFTER_CHARGEBACK`: Refunded after chargeback.\n* `WITHDRAWN`: Withdrawn.\n* `WON_ARBITRATION`: Won arbitration.\n* `WON_FIRST_CHARGEBACK`: Won first chargeback.\n* `WON_PREARBITRATION`: Won prearbitration.\n",
      "enum": [
        "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
      ],
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "description": "Status types:\n* `NEW` - New dispute case is opened.\n* `PENDING_CUSTOMER` - Lithic is waiting for customer to provide more information.\n* `SUBMITTED` - Dispute is submitted to the card network.\n* `REPRESENTMENT` - Case has entered second presentment.\n* `PREARBITRATION` - Case has entered prearbitration.\n* `ARBITRATION` - Case has entered arbitration.\n* `CASE_WON` - Case was won and credit will be issued.\n* `CASE_CLOSED` - Case was lost or withdrawn.\n",
      "enum": [
        "ARBITRATION",
        "CASE_CLOSED",
        "CASE_WON",
        "NEW",
        "PENDING_CUSTOMER",
        "PREARBITRATION",
        "REPRESENTMENT",
        "SUBMITTED"
      ],
      "type": "string"
    },
    "token": {
      "description": "Globally unique identifier.",
      "format": "uuid",
      "type": "string"
    },
    "transaction_token": {
      "description": "The transaction that is being disputed. A transaction can only be disputed once but may have multiple dispute cases.",
      "format": "uuid",
      "type": "string"
    }
  },
  "required": [
    "amount",
    "arbitration_date",
    "created",
    "customer_filed_date",
    "customer_note",
    "network_claim_ids",
    "network_filed_date",
    "network_reason_code",
    "prearbitration_date",
    "primary_claim_id",
    "reason",
    "representment_date",
    "resolution_date",
    "resolution_note",
    "resolution_reason",
    "status",
    "token",
    "transaction_token"
  ],
  "type": "object"
}