Dispute

July 20, 2026 ยท View on GitHub

Schema representing a dispute.

A dispute is a challenge raised by a customer or their bank regarding a payment.

Fields

FieldTypeRequiredDescriptionExample
created_atdate:heavy_check_mark:Creation timestamp of the object.
modified_atdate:heavy_check_mark:Last modification timestamp of the object.
idstr:heavy_check_mark:The ID of the object.
statusmodels.DisputeStatus:heavy_check_mark:N/A
resolvedbool:heavy_check_mark:Whether the dispute has been resolved (won or lost).false
closedbool:heavy_check_mark:Whether the dispute is closed (prevented, won, or lost).false
amountint:heavy_check_mark:Amount in cents disputed.1000
tax_amountint:heavy_check_mark:Tax amount in cents disputed.200
currencystr:heavy_check_mark:Currency code of the dispute.usd
reasonNullable[str]:heavy_check_mark:The reason for the dispute as reported by the card network (e.g. fraudulent, product_not_received). None until the processor reports it.fraudulent
evidence_due_bydate:heavy_check_mark:Deadline to submit evidence in response to the dispute. None when no response is required.
past_duebool:heavy_check_mark:Whether the evidence submission deadline has passed.false
order_idstr:heavy_check_mark:The ID of the order associated with the dispute.57107b74-8400-4d80-a2fc-54c2b4239cb3
payment_idstr:heavy_check_mark:The ID of the payment associated with the dispute.42b94870-36b9-4573-96b6-b90b1c99a353
customermodels.DisputeCustomer:heavy_check_mark:N/A
case_idNullable[str]:heavy_check_mark:The ID of the support case for this dispute, if one was opened.