Dispute History Record Object


A dispute history record represents a snapshot of dispute information at a specific point in time.

Records are automatically created whenever a dispute changes status, stage, or other key properties, providing a complete audit trail for compliance and audit requirements.

Properties
channelstringRead-onlyimmutable

Channel through which the dispute is being processed.


chargeIdstringRead-onlyformat GUIDimmutable

ID of the charge that is being disputed.


createdDatestringRead-onlyimmutableformat date-time

Date and time the dispute history record was created.


disputeIdstringformat GUIDimmutable

ID of the dispute that this history record is a snapshot of.


dueDatestringRead-onlyimmutableformat date-time

The latest date and time until which the dispute can remain in its current status.

If this date passes, the dispute will be resolved against the party that is required to take action. For example, if the status is WAITING_MERCHANT, and the due date passes, the dispute will be LOST and a refund will be processed automatically.


extendedFieldsExtendedFields

Custom field data for the dispute history record object.

Extended fields must be configured in the app dashboard before they can be accessed with API calls.


idstringRead-onlyformat GUIDimmutable

Dispute history record ID.


revisionstringRead-onlyformat int64

Revision number, which increments by 1 each time the dispute history record is updated. To prevent conflicting changes, the existing revision must be specified when updating a dispute history record.


stagestringRead-onlyimmutable

Stage of the dispute process.


statusstringRead-onlyimmutable

Status of the dispute at the time this record was created. Indicates what action was required and by whom at this point in the dispute lifecycle.


tagsTags

Tags assigned to the dispute history record for organization and filtering purposes.


updatedDatestringRead-onlyimmutableformat date-time

Date and time the dispute history record was last updated.

Did this help?