Update chargeback request
dispute_token
token
uuid
required
amount
integer
Amount for chargeback
customer_filed_date
date-time
Date the customer filed the chargeback request
customer_note
string
Customer description
reason
string
enum
Reason for chargeback
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
Show 14 enum values
200 OK
object
Dispute
amount
integer
required
Amount under dispute. May be different from the original transaction amount.
arbitration_date
date-time | null
required
Date dispute entered arbitration.
created
date-time
required
Timestamp of when first Dispute was reported.
customer_filed_date
date-time | null
required
Date that the dispute was filed by the customer making the dispute.
customer_note
string | null
required
End customer description of the reason for the dispute.
network_claim_ids
required
Unique identifiers for the dispute from the network.
array null
network_claim_ids array of strings
network_filed_date
date-time | null
required
Date that the dispute was submitted to the network.
network_reason_code
string | null
required
Network reason code used to file the dispute.
prearbitration_date
date-time | null
required
Date dispute entered pre-arbitration.
primary_claim_id
string | null
required
Unique identifier for the dispute from the network. If there are multiple, this will be the first claim id set by the network
reason
string
enum
required
Dispute reason:
ATM_CASH_MISDISPENSECANCELLEDDUPLICATEDFRAUD_CARD_NOT_PRESENTFRAUD_CARD_PRESENTFRAUD_OTHERGOODS_SERVICES_NOT_AS_DESCRIBEDGOODS_SERVICES_NOT_RECEIVEDINCORRECT_AMOUNTMISSING_AUTHOTHERPROCESSING_ERRORREFUND_NOT_PROCESSEDRECURRING_TRANSACTION_NOT_CANCELLED
representment_date
date-time | null
required
Date the representment was received.
resolution_date
date-time | null
required
Date that the dispute was resolved.
resolution_note
string | null
required
Note by Dispute team on the case resolution.
resolution_reason
string | null
enum
required
Reason for the dispute resolution:
CASE_LOSTNETWORK_REJECTEDNO_DISPUTE_RIGHTS_3DSNO_DISPUTE_RIGHTS_BELOW_THRESHOLDNO_DISPUTE_RIGHTS_CONTACTLESSNO_DISPUTE_RIGHTS_HYBRIDNO_DISPUTE_RIGHTS_MAX_CHARGEBACKSNO_DISPUTE_RIGHTS_OTHERPAST_FILING_DATEPREARBITRATION_REJECTEDPROCESSOR_REJECTED_OTHERREFUNDEDREFUNDED_AFTER_CHARGEBACKWITHDRAWNWON_ARBITRATIONWON_FIRST_CHARGEBACKWON_PREARBITRATIONnull
status
string
enum
required
Status types:
NEWPENDING_CUSTOMERSUBMITTEDREPRESENTMENTPREARBITRATIONARBITRATIONCASE_WONCASE_CLOSED
token
uuid
required
Globally unique identifier.
transaction_token
uuid
required
The transaction that is being disputed. A transaction can only be disputed once but may have multiple dispute cases.
400 A parameter in the query given in the request does not match the valid queries for the endpoint.
401 User has not been authenticated
Invalid or missing API key.
API key is not active.
The API key used is no longer active.
Could not find API key.
The API key provided is not associated with any user.
Please provide API key in Authorization header.
The Authorization header is not in the request.
Please provide API key in the form Authorization: [api-key].
The Authorization header is not formatted properly.
Insufficient privileges. Issuing API key required.
Write access requires an Issuing API key. Reach out at lithic.com/contact.
Insufficient privileges to create virtual cards.
Creating virtual cards requires an additional privilege.
404 The specified resource was not found.
422 Unprocessable entity.
429 Client has exceeded the number of allowed requests in a given time period.
Rate limited, too many requests per second.
User has exceeded their per second rate limit.
Rate limited, reached daily limit.
User has exceeded their daily rate limit.
Rate limited, too many keys tried.
One IP has queried too many different API keys.
Example Request
curl --request PATCH \
--url https://sandbox.lithic.com/v1/disputes/dispute_token \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"amount": 0,
"customer_filed_date": "2026-07-18T00:25:20.126Z",
"customer_note": "string",
"reason": "ATM_CASH_MISDISPENSE"
}
'
Example Response
{
"amount": 0,
"arbitration_date": "2026-07-18T00:25:20.126Z",
"created": "2026-07-18T00:25:20.126Z",
"customer_filed_date": "2026-07-18T00:25:20.126Z",
"customer_note": "string",
"network_claim_ids": [
"string"
],
"network_filed_date": "2026-07-18T00:25:20.126Z",
"network_reason_code": "string",
"prearbitration_date": "2026-07-18T00:25:20.126Z",
"primary_claim_id": "string",
"reason": "ATM_CASH_MISDISPENSE",
"representment_date": "2026-07-18T00:25:20.126Z",
"resolution_date": "2026-07-18T00:25:20.126Z",
"resolution_note": "string",
"resolution_reason": "CASE_LOST",
"status": "ARBITRATION",
"token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"transaction_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}