eBay Trading APIVersion 1119

DisputeExplanationCodeType ( token )

Enumerated type that contains the explanations for a buyer or seller opening a case against one another. These values are specified in the DisputeExplanation field of AddDispute, and are returned in the GetUserDisputes and GetDispute calls. The DisputeReason value will dictate what DisputeExplanation values that can be used/returned.

Note: The dispute calls in the Trading API are not compatible with 'Item Not Received' or 'Significantly Not As Described' cases initiated by buyers through the eBay Money Back Guarantee program. The Post-Order API is used to retrieve and/or respond to eBay Money Back Guarantee cases programmatically.

Types that use DisputeExplanationCodeType:

Calls that use one or more values of DisputeExplanationCodeType:

Enumeration Values

Value Description
BuyerHasNotResponded This value indicates that the buyer has not paid for the order line item, and has not responded to the seller regarding payment. This value is allowed when the DisputeReason value is BuyerHasNotPaid.
BuyerNoLongerWantsItem This value indicates that the buyer no longer wants the item (buyer remorse), and the seller is willing to cancel the order line item. This value is allowed when the DisputeReason value is TransactionMutuallyCanceled.
BuyerNotClearedToPay This value indicates that the buyer has not paid for the order line item, and is not cleared by eBay to pay. This value is allowed when the DisputeReason value is BuyerHasNotPaid.
BuyerNotPaid This value indicates that the buyer has not paid for the order line item. This value is allowed when the DisputeReason value is BuyerHasNotPaid.
BuyerPaymentNotReceivedOrCleared This value indicates that the buyer has not paid the seller for the order line item, or has paid the seller but the payment has not cleared. This value is allowed when the DisputeReason value is BuyerHasNotPaid.
BuyerPurchasingMistake This value indicates that the buyer made a mistake by purchasing the item, and the seller is willing to cancel the order line item. This value is allowed when the DisputeReason value is TransactionMutuallyCanceled.
BuyerRefusedToPay This value indicates that the buyer has not paid for the order line item, and according to the seller, has refused to pay for the order line item. This value is allowed when the DisputeReason value is BuyerHasNotPaid.
BuyerReturnedItemForRefund This value indicates that the buyer has returned the item, and seller has agreed to cancel the order and issue a refund to the buyer. This value is allowed when the DisputeReason value is TransactionMutuallyCanceled.
CustomCode Reserved for internal or future use.
OtherExplanation This value can be used when no other explanation in DisputeExplanationCodeType is appropriate for the situation. This value is allowed when the DisputeReason value is BuyerHasNotPaid or TransactionMutuallyCanceled.
SellerDoesntShipToCountry This value indicates that the buyer is requesting shipment of the item to a country that is on the seller's ship-to exclusion list. This value is allowed when the DisputeReason value is BuyerHasNotPaid or TransactionMutuallyCanceled.
SellerRanOutOfStock This value indicates that the seller ran out of stock on the item, cannot fulfill the order, and has to cancel the order line item. This value is allowed when the DisputeReason value is TransactionMutuallyCanceled.
ShippingAddressNotConfirmed This value indicates that the buyer is requesting shipment of the item to an unconfirmed (not on file with eBay) address. This value is allowed when the DisputeReason value is BuyerHasNotPaid or TransactionMutuallyCanceled.
UnableToResolveTerms This value indicates that the buyer and seller were unable to resolve a disagreement over terms, and the seller is willing to cancel the order line item. This value is allowed when the DisputeReason value is TransactionMutuallyCanceled.
Unspecified This value can be used when no other explanation in DisputeExplanationCodeType is appropriate for the situation. This value is allowed when the DisputeReason value is ItemNotReceived or SignificantlyNotAsDescribed. This value cannot be used in AddDispute.
UPIAssistance This value indicates that the Unpaid Item case was opened by eBay through the Unpaid Item Assistance mechanism. This value cannot be used in AddDispute.
UPIAssistanceDisabled This value indicates that the Unpaid Item case was opened by eBay through the Unpaid Item Assistance mechanism, and then was subsequently converted to a manual dispute, either by the seller or by eBay. This value cannot be used in AddDispute.
  * See the Enumeration Index to see exact use of each enumeration value in the API.