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

Submit an Issuing dispute

Submits an Issuing dispute to the card network for review. The API validates that the evidence required for the dispute's reason is present before submission. Use expand or metadata to control the returned representation or attach metadata to the request.

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

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

Optional submission options, including response expansion and metadata.

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 submitted Issuing dispute object with its updated status, evidence, transaction, and related balance transactions.
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. The dispute must include the evidence required for its selected reason before submission, and expand field names must be no longer than 5000 characters.