<- Object

Object

All versions ->

DisputeBeta

Represents a dispute a cardholder initiated with their bank.

Link to section

Properties

Link to section

dispute_id

string

Unique ID for this Dispute, generated by Square.

Min Length
1
Max Length
40
Link to section

amount_money

The disputed amount. The amount can be less than the entire transaction amount. For example, a cardholder purchased multiple items, however initiated dispute only for some of the items.

Link to section

reason

string

The dispute reason why cardholder initiated dispute with their bank.

Link to section

state

string

The current state of this dispute.

Link to section

due_at

string

The time when the next action is due, 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 [ ]

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 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 Timestamp when 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

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

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 location where dispute originated.

Min Length
1
Max Length
40