<- Object

Object

All versions ->

Dispute

Represents a dispute a cardholder initiated with their bank.

Link to section

Properties

Link to section

dispute_id

string

Deprecated

The unique ID for this Dispute, generated by Square.

Min Length
1
Max Length
40
Link to section

id

string

The unique ID for this Dispute, generated by Square.

Min Length
1
Max Length
40
Link to section

amount_money

The disputed amount, which can be less than the total transaction amount. For instance, if multiple items were purchased but the cardholder only initiates a dispute over some of the items.

Link to section

reason

string

The reason why the cardholder initiated the dispute.

Link to section

state

string

The current state of this dispute.

Link to section

due_at

string

The deadline by which the seller must respond to the dispute, in RFC 3339 format.

Min Length
1
Max Length
40
Link to section

disputed_payment

The payment challenged in this dispute.

Link to section

evidence_ids

string [ ]

Deprecated

The IDs of the evidence associated with the dispute.

Link to section

card_brand

string

The card brand used in the disputed payment.

Link to section

created_at

string

Read only The timestamp when the dispute was created, in RFC 3339 format.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Min Length
1
Max Length
40
Link to section

updated_at

string

Read only The timestamp when the dispute was last updated, in RFC 3339 format.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Min Length
1
Max Length
40
Link to section

brand_dispute_id

string

The ID of the dispute in the card brand system, generated by the card brand.

Min Length
1
Max Length
40
Link to section

reported_date

string

Deprecated

The timestamp when the dispute was reported, in RFC 3339 format.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Min Length
1
Max Length
40
Link to section

reported_at

string

The timestamp when the dispute was reported, in RFC 3339 format.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Min Length
1
Max Length
40
Link to section

version

integer(32-bit)

The current version of the Dispute.

Link to section

location_id

string

The ID of the location where the dispute originated.

Min Length
1
Max Length
40