Skip to content
Stainless Stainless Stainless SDKs

Disputes

Disputes

Last updated: (timestamp)

Disputes

disputes
Methods
Initiate dispute
post/v1/disputes

Initiate a dispute.

Get dispute
get/v1/disputes/{dispute_token}

Get dispute.

Update dispute
patch/v1/disputes/{dispute_token}

Update dispute. Can only be modified if status is NEW.

List disputes
get/v1/disputes

List disputes.

Withdraw dispute
delete/v1/disputes/{dispute_token}

Withdraw dispute.

Withdraw dispute evidence
delete/v1/disputes/{dispute_token}/evidences/{evidence_token}

Soft delete evidence for a dispute. Evidence will not be reviewed or submitted by Lithic after it is withdrawn.

Initiate dispute evidence upload
post/v1/disputes/{dispute_token}/evidences

Use this endpoint to upload evidences for the dispute. It will return a URL to upload your documents to. The URL will expire in 30 minutes.

Uploaded documents must either be a jpg, png or pdf file, and each must be less than 5 GiB.

List dispute evidences
get/v1/disputes/{dispute_token}/evidences

List evidence metadata for a dispute.

Get dispute evidence
get/v1/disputes/{dispute_token}/evidences/{evidence_token}

Get a dispute's evidence metadata.

Domain Types
Dispute
Disputeobject

Dispute.

ShowShow
tokenstring

Globally unique identifier.

formatuuid
amountnumber

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

arbitration_datestring

Date dispute entered arbitration.

formatdate-time
createdstring

Timestamp of when first Dispute was reported.

formatdate-time
customer_filed_datestring

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

formatdate-time
customer_notestring

End customer description of the reason for the dispute.

maxLength10000
network_claim_idsarray of string

Unique identifiers for the dispute from the network.

network_filed_datestring

Date that the dispute was submitted to the network.

formatdate-time
network_reason_codestring

Network reason code used to file the dispute.

prearbitration_datestring

Date dispute entered pre-arbitration.

formatdate-time
primary_claim_idstring

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

reasonenum
Accepts one of the following: "ATM_CASH_MISDISPENSE", "CANCELLED", "DUPLICATED", 11 more

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.
Hide ParametersShow Parameters
"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"
representment_datestring

Date the representment was received.

formatdate-time
resolution_datestring

Date that the dispute was resolved.

formatdate-time
resolution_notestring

Note by Dispute team on the case resolution.

maxLength10000
resolution_reasonenum
Accepts one of the following: "CASE_LOST", "NETWORK_REJECTED", "NO_DISPUTE_RIGHTS_3DS", 14 more

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.
Hide ParametersShow Parameters
"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"
statusenum
Accepts one of the following: "ARBITRATION", "CASE_CLOSED", "CASE_WON", 5 more

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.
Hide ParametersShow Parameters
"ARBITRATION"
"CASE_CLOSED"
"CASE_WON"
"NEW"
"PENDING_CUSTOMER"
"PREARBITRATION"
"REPRESENTMENT"
"SUBMITTED"
transaction_tokenstring

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

formatuuid
Dispute Evidence
DisputeEvidenceobject

Dispute evidence.

ShowShow
tokenstring

Globally unique identifier.

formatuuid
createdstring

Timestamp of when dispute evidence was created.

formatdate-time
dispute_tokenstring

Dispute token evidence is attached to.

formatuuid
upload_statusenum
Accepts one of the following: "DELETED", "ERROR", "PENDING", 2 more

Upload status types:

  • DELETED - Evidence was deleted.
  • ERROR - Evidence upload failed.
  • PENDING - Evidence is pending upload.
  • REJECTED - Evidence was rejected.
  • UPLOADED - Evidence was uploaded.
Hide ParametersShow Parameters
"DELETED"
"ERROR"
"PENDING"
"REJECTED"
"UPLOADED"
download_urlstring
optional

URL to download evidence. Only shown when upload_status is UPLOADED.

filenamestring
optional

File name of evidence. Recommended to give the dispute evidence a human-readable identifier.

upload_urlstring
optional

URL to upload evidence. Only shown when upload_status is PENDING.

Dispute Initiate Evidence Upload Response
DisputeEvidenceobject

Dispute evidence.

ShowShow
tokenstring

Globally unique identifier.

formatuuid
createdstring

Timestamp of when dispute evidence was created.

formatdate-time
dispute_tokenstring

Dispute token evidence is attached to.

formatuuid
upload_statusenum
Accepts one of the following: "DELETED", "ERROR", "PENDING", 2 more

Upload status types:

  • DELETED - Evidence was deleted.
  • ERROR - Evidence upload failed.
  • PENDING - Evidence is pending upload.
  • REJECTED - Evidence was rejected.
  • UPLOADED - Evidence was uploaded.
Hide ParametersShow Parameters
"DELETED"
"ERROR"
"PENDING"
"REJECTED"
"UPLOADED"
download_urlstring
optional

URL to download evidence. Only shown when upload_status is UPLOADED.

filenamestring
optional

File name of evidence. Recommended to give the dispute evidence a human-readable identifier.

upload_urlstring
optional

URL to upload evidence. Only shown when upload_status is PENDING.