A set of date time fields related to the dispute case. Depending on the disputeStatus and disputeStage of the dispute, different date time fields are relevant. For example, when the disputeStatus is "EVIDENCE_REQUESTED", the responseDueDate field indicates the deadline to respond to the dispute.

The closedDateTime field represents the date and time when the dispute was closed. This field is only returned for closed disputes. Disputes that are open too long are automatically closed.

Declaration

public DisputeDateTimeData DisputeDateTimeData { get; set; }

Property Value

Type	Description
DisputeDateTimeData

DisputeId

The unique identifier for a dispute.

Declaration

public string DisputeId { get; set; }

Property Value

Type	Description
string

DisputeReferences

A set of references related to the dispute case.

Declaration

public DisputeReferences DisputeReferences { get; set; }

Property Value

Type	Description
DisputeReferences

DisputeStage

The current stage in the lifecycle of the dispute.

Possible values are:

CREATED (The dispute case includes no dispute relevant information)
FRAUD (The dispute case is opened with a fraud report (Issuer cases only))
INQUIRY (Pre-dispute phase)
DISPUTE (The dispute case reached the dispute stage, which includes dispute and representment handling)
PRE_ARBITRATION (The dispute case is in the first stage of the case filing process, before escalation to arbitration)
ARBITRATION (The dispute case filing process escalated to the arbitration phase)
PRE_COMPLIANCE (The dispute case is in the first stage of the case filing process, before escalation to compliance)
COMPLIANCE (The dispute case filing process escalated to the compliance phase)

Declaration

public string DisputeStage { get; set; }

Property Value

Type	Description
string

DisputeStatus

The current status of the dispute.

Possible values are:

For IN_PROGRESS dispute status category:
- REVIEW_BY_ACQUIRER (Next action is on Acquirer side)
- REVIEW_BY_ISSUER (Next action is on Issuer side)
- REVIEW_BY_SCHEME (Next action is on Scheme side)
For NEEDS_RESPONSE dispute status category:
- EVIDENCE_REQUESTED (Acquirer request evidence from merchant)
For WON dispute status category:
- ISSUER_WITHDRAWN (Issuer withdraw the dispute and accept liability)
- SUCCESSFUL_DEFENSE (Acquirer dispute defense was successful)
- SCHEME_RULING (Dispute is escalated and scheme ruled in favor of Merchant)
For LOST dispute status category:
- UNSUCCESSFUL_DEFENSE (Acquirer dispute defense was not successful)
- UNANSWERED_EXPIRED (Dispute respond time expired, no further defense is possible)
- ACCEPTED (Acquirer accepted liability)
- SCHEME_RULING (Dispute is escalated and scheme ruled in favor of Issuer)
For CANCELLED dispute status category:
- DISPUTE_CANCELLED (Issuer withdrew the dispute)

Declaration

public string DisputeStatus { get; set; }

Property Value

Type	Description
string

DisputeStatusCategory

The category of the current status of the dispute.

Possible values are:

IN_PROGRESS (Dispute process is ongoing and has no final decision. The merchant currently waits for further status updates.)
NEEDS_RESPONSE (The merchant is contacted to provide supporting evidence documents before a deadline)
WON (Dispute case has been won)
LOST (Dispute case has been lost)
CANCELLED (Dispute has been withdrawn)

Declaration

public string DisputeStatusCategory { get; set; }

Property Value

Type	Description
string

IsOpen

Indicates whether the dispute is open or closed. An open dispute is a dispute that's still in the process of being resolved, while a closed dispute is a dispute that has been resolved.

Declaration

public bool? IsOpen { get; set; }

Property Value

Type	Description
bool?

MerchantBalanceAmount

Amount with an indicator whether it's a debit or credit amount.

Declaration

public SignedAmountData MerchantBalanceAmount { get; set; }

Property Value

Type	Description
SignedAmountData

MerchantData

Data related to the merchant involved in the dispute.

Declaration

public DisputeMerchantData MerchantData { get; set; }

Property Value

Type	Description
DisputeMerchantData

OriginalDisputeAmount

Amount for the operation.

Declaration

public AmountData OriginalDisputeAmount { get; set; }

Property Value

Type	Description
AmountData

OriginalTransactionData

Data related to the original transaction that led to the dispute.

Declaration

public OriginalTransactionData OriginalTransactionData { get; set; }

Property Value

Type	Description
OriginalTransactionData

SchemeReason

The reason provided by the card scheme for the dispute.

Declaration

public string SchemeReason { get; set; }

Property Value

Type	Description
string

SchemeReasonDescription

The human readable description of the reason provided by the card scheme for the dispute.

Declaration

public string SchemeReasonDescription { get; set; }

Property Value

Type	Description
string

UnifiedCategory

The unified category of the dispute, used for categorization and reporting purposes. Only present if a dispute was received.

Possible values are:

AUTHORIZATION_RELATED (authorization related disputes)
FRAUD_RELATED (fraud related disputes)
CONSUMER_DISPUTE (consumer initiated disputes)
PROCESSING_ERROR (error during the payment processing leads to a dispute)
OTHER (collection of diverse dispute reasons)

Declaration

public string UnifiedCategory { get; set; }

Property Value

Type	Description
string

UnifiedReason

The unified reason for the dispute, used for categorization and reporting purposes. Only present if a dispute was received.

Possible values are:

FRAUDULENT_CARD_USAGE (Fraudulent use of card)
UNAUTHORIZED_TRANSACTION (No valid Issuer authorization)
GENERAL_PAYMENT_ERROR (General payment error)
INVALID_TRANSACTION_TYPE (Invalid transaction type)
INVALID_CURRENCY (Invalid currency)
INVALID_CARD_NUMBER (Invalid card number)
INVALID_AMOUNT (Invalid amount)
DUPLICATE_CHARGE_OR_PAID_BY_OTHER_MEANS (Duplicate charge or paid by other means)
GENERAL_CUSTOMER_DISPUTE (General customer dispute)
GOODS_OR_SERVICES_NOT_RECEIVED (Goods or services not received)
CANCELLED_SUBSCRIPTION (Cancelled subscription)
GOODS_OR_SERVICES_NOT_MATCHING_ORDER (Goods or services not matching order)
COUNTERFEIT_MERCHANDISE (Counterfeit merchandise)
DUE_REFUND_NOT_RECEIVED (Due refund not received)
CHARGE_NOT_ACCEPTED ((Subsequent) Charge not accepted)
OTHER (Other)

Declaration

public string UnifiedReason { get; set; }

Property Value

Type	Description
string