Sample - Stripe API
POST/v1/issuing/disputes/{dispute}

Update an Issuing dispute

Updates an existing Issuing dispute with the values you provide, leaving omitted properties unchanged. Use evidence to add or clear evidence fields, and use amount to set the disputed amount in the card's smallest currency unit. Pass an empty string for an evidence property or metadata value when the schema permits clearing it.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.
  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 4 body fields
disputestringrequired
The unique identifier of the Issuing dispute to update. Maximum 5000 characters.

Optional partial update for an Issuing dispute; omitted fields remain unchanged.

amountintegeroptional
The dispute amount in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
evidenceobjectoptional
Evidence provided for the dispute.
expandarray<string>optional
Specifies which fields in the response should be expanded.
metadataobjectoptional
Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.

2 status codes
200Returns the updated Issuing dispute object with its amount, evidence, metadata, status, and related transaction details.
amountintegerrequired
Disputed amount in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Usually the amount of the `transaction`, but can differ (usually because of currency fluctuation).
balance_transactionsarray<BalanceTransaction>optional
List of balance transactions associated with the dispute.
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
currencystringrequired
The currency the `transaction` was made in.
evidenceobjectrequired
idstringrequired
Unique identifier for the object.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
loss_reasonstringoptional
The enum that describes the dispute loss outcome. If the dispute is not lost, this field will be absent. New enum values may be added in the future, so be sure to handle unknown values.
Allowed:cardholder_authentication_issuer_liabilityeci5_token_transaction_with_tavvexcess_disputes_in_timeframehas_not_met_the_minimum_dispute_amount_requirementsinvalid_duplicate_disputeinvalid_incorrect_amount_disputeinvalid_no_authorizationinvalid_use_of_disputesmerchandise_delivered_or_shippedmerchandise_or_service_as_describednot_cancelledother
metadataobjectrequired
Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:issuing.dispute
statusstringrequired
Current status of the dispute.
Allowed:expiredlostsubmittedunsubmittedwon
transactionstringrequired
The transaction being disputed.
treasuryobjectoptional
[Treasury](https://docs.stripe.com/api/treasury) details related to this dispute if it was created on a [FinancialAccount](https://docs.stripe.com/api/treasury/financial_accounts)
defaultReturned when the request cannot be processed; the response contains an `error` object with a reason and error type.
errorobjectrequired

Error handling

dispute must identify the Issuing dispute and must not exceed 5000 characters. evidence.reason must be one of: canceled, duplicate, fraudulent, merchandise_not_as_described, no_valid_authorization, not_received, other, or service_not_as_described. expand field names must be no longer than 5000 characters, and lookup_key is not part of this request.