eBay Merchant Data APIVersion 1255
 

DisputeExplanationCodeType ( token )

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

Note: Only Unpaid Item cases are now supported by the Dispute calls of the Trading API. These calls no longer support Item not Received (INR) or Significantly not as Described (SNAD) disputes created through PayPal, since this is no longer an option for eBay buyers. eBay buyers must create an INR case through eBay's Resolution Center, and these calls also do not support eBay Money Back Guarantee cases.

To respond to an eBay Money Back Guarantee case, the seller should use the Case Management calls of the Post-Order API or manage/respond to cases manually through the eBay Resolution Center.

No calls use 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.
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.
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 cannot be used in AddDispute, but it may be returned in the GetDispute or GetUserDisputes calls if the dispute explanation is unknown or was not specified.
UPIAssistance This value will be returned in GetDispute or GetUserDisputes calls if 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.