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

IssuingDisputeEvidence

object

canceled IssuingDisputeCanceledEvidence object

optional

duplicate IssuingDisputeDuplicateEvidence object

optional

fraudulent IssuingDisputeFraudulentEvidence object

optional

merchandise_not_as_described IssuingDisputeMerchandiseNotAsDescribedEvidence object

optional

not_received IssuingDisputeNotReceivedEvidence object

optional

other IssuingDisputeOtherEvidence object

optional

reason string

required

The reason for filing the dispute. Its value will match the field containing the evidence.

Allowed: "canceled""duplicate""fraudulent""merchandise_not_as_described""not_received""other""service_not_as_described"

service_not_as_described IssuingDisputeServiceNotAsDescribedEvidence object

optional

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"}