eBay Post-Order APIVersion 2.7.2
 

DecideReturnRequest

The base request type of the POST /post-order/v2/return/{returnId}/decide method.

Call that uses DecideReturnRequest:

Fields



comments ( Text ) [0..?]
This container is used by the seller or buyer to provide more information about the action that is being performed with the decide method.
See the Field Index to learn which calls use comments.

decision ( DecisionEnum ) [0..?]
This field must be included in each request, and the value that is supplied here will depend on whether the seller or the buyer is using this method, and it will also depend on the current state of the return request. The POST /post-order/v2/return/{returnId}/decide request will fail unless an appropriate value is specified in this field.

Sellers can use this method to approve or decline a return request, offer a partial refund to the buyer, offer a replacement item to the buyer, or provide a Return Merchandise Authorization (RMA) number to the buyer.

Buyers can use this method to accept or decline a partial refund offer, or accept or decline a replacement item from the seller.
See the Field Index to learn which calls use decision.

keepOriginalItem ( boolean ) [0..?]
The seller can include this field and set it to true if they are OK with the buyer keeping the original item they received, and not requiring them to return the item. A seller may choose to do this in the case of a SNAD item or if the buyer is claiming that the item arrived damaged or was missing parts. If a replacement item is being shipped to the buyer, the buyer will not receive a full refund, but based on what buyer and seller agree on, it is possible that the seller could offer a partial refund or order adjustment.

Default: false
See the Field Index to learn which calls use keepOriginalItem.

partialRefundAmount ( Amount ) [0..?]
This container is conditionally required if the seller is using the decide method to offer a partial refund amount to the buyer in order to settle the return request. This amount is the amount the seller is willing to offer the buyer as a partial refund. This field has no relevance if anything other than OFFER_PARTIAL_REFUND is passed in the decision field.
See the Field Index to learn which calls use partialRefundAmount.

RMANumber ( string ) [0..?]
This field is conditionally required if the seller is using the POST /post-order/v2/return/{returnId}/decide method to provide a return merchandise authorization (RMA) to the buyer. The RMA value cannot be validated by eBay, so the seller should pay close attention to ensure that the RMA is accurate. If an RMA is provided in this field, the decision value should be PROVIDE_RMA.
See the Field Index to learn which calls use RMANumber.

rMAProvided ( boolean ) [0..?]
If set to true, it indicates that the seller provided an RMA number to the buyer for processing of the return.

Default: false
See the Field Index to learn which calls use rMAProvided.