Schema2020-08-27object

issuing.dispute

As a [card issuer](https://stripe.com/docs/issuing), you can dispute transactions that the cardholder does not recognize, suspects to be fraudulent, or has other issues with. Related guide: [Disputing Transactions](https://stripe.com/docs/issuing/purchases/disputes)

Source: openapi/spec3.json
Commit: d70de345383d
Active snapshot: da69df7e6e11

IssuingDisputeMerchandiseNotAsDescribedEvidence

object

additional_documentation

optionalnullable

(ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Additional documentation supporting the dispute.

explanation string

optionalnullable

Explanation of why the cardholder is disputing this transaction.

maxLength:5000

received_at integer (unix-time)

optionalnullable

Date when the product was received.

return_description string

optionalnullable

Description of the cardholder's attempt to return the product.

maxLength:5000

return_status string

optionalnullable

Result of cardholder's attempt to return the product.

Allowed: "merchant_rejected""successful"

returned_at integer (unix-time)

optionalnullable

Date when the product was returned or attempted to be returned.

Root JSON Schema

{"description":"As a [card issuer](https://stripe.com/docs/issuing), you can dispute transactions that the cardholder does not recognize, suspects to be fraudulent, or has other issues with.\n\nRelated guide: [Disputing Transactions](https://stripe.com/docs/issuing/purchases/disputes)","properties":{"amount":{"description":"Disputed amount. Usually the amount of the `transaction`, but can differ (usually because of currency fluctuation).","type":"integer"},"balance_transactions":{"description":"List of balance transactions associated with the dispute.","items":{"$ref":"#/components/schemas/balance_transaction"},"nullable":true,"type":"array"},"created":{"description":"Time at which the object was created. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"currency":{"description":"The currency the `transaction` was made in.","type":"string"},"evidence":{"$ref":"#/components/schemas/issuing_dispute_evidence"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"livemode":{"description":"Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.","type":"boolean"},"metadata":{"additionalProperties":{"maxLength":500,"type":"string"},"description":"Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.","type":"object"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["issuing.dispute"],"type":"string"},"status":{"description":"Current status of the dispute.","enum":["expired","lost","submitted","unsubmitted","won"],"type":"string"},"transaction":{"anyOf":[{"maxLength":5000,"type":"string"},{"$ref":"#/components/schemas/issuing.transaction"}],"description":"The transaction being disputed.","x-expansionResources":{"oneOf":[{"$ref":"#/components/schemas/issuing.transaction"}]}}},"required":["amount","created","currency","evidence","id","livemode","metadata","object","status","transaction"],"title":"IssuingDispute","type":"object","x-expandableFields":["balance_transactions","evidence","transaction"],"x-resourceId":"issuing.dispute"}