Schema representing a dispute.
A dispute is a challenge raised by a customer or their bank regarding a payment.
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
created_at |
date | ✔️ | Creation timestamp of the object. | |
modified_at |
date | ✔️ | Last modification timestamp of the object. | |
id |
str | ✔️ | The ID of the object. | |
status |
models.DisputeStatus | ✔️ | N/A | |
resolved |
bool | ✔️ | Whether the dispute has been resolved (won or lost). | false |
closed |
bool | ✔️ | Whether the dispute is closed (prevented, won, or lost). | false |
amount |
int | ✔️ | Amount in cents disputed. | 1000 |
tax_amount |
int | ✔️ | Tax amount in cents disputed. | 200 |
currency |
str | ✔️ | Currency code of the dispute. | usd |
reason |
Nullable[str] | ✔️ | 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_by |
date | ✔️ | Deadline to submit evidence in response to the dispute. None when no response is required. |
|
past_due |
bool | ✔️ | Whether the evidence submission deadline has passed. | false |
order_id |
str | ✔️ | The ID of the order associated with the dispute. | 57107b74-8400-4d80-a2fc-54c2b4239cb3 |
payment_id |
str | ✔️ | The ID of the payment associated with the dispute. | 42b94870-36b9-4573-96b6-b90b1c99a353 |
customer |
models.DisputeCustomer | ✔️ | N/A | |
case_id |
Nullable[str] | ✔️ | The ID of the support case for this dispute, if one was opened. |