Indicates if the request was successful. If it was not successful, indicates whether the error is a severe error (causing the request to fail) or an informational error (a warning) that should be communicated to the user. The request was processed successfully. The request was not processed successfully. When a serious application-level error occurs, the error is returned instead of the business data. The request was processed successfully but with some warnings. See errorMessage.error to determine the nature of the warning. The request was processed successfully, but something occurred that might affect your application or the user. See errorMessage.error to determine which portions of the request failed. Base response container for all service operations. Contains error information associated with the request. Always Information for an error or warning that occurred when eBay processed the request. Conditionally Always Always There are three categories of errors: request errors, application errors, and system errors. Contains details about a single warning or error. A unique code that identifies the particular warning or error condition that occurred. Your application can use error codes as identifiers in your customized error- handling algorithms. Conditionally A description of the warning or error condition that occurred. Conditionally Information for warnings or errors that occurred when eBay processed the request. Note: This field is not returned if the value of ack is Success. A container for the warning or error details. Conditionally Various warning and error messages return one or more variables that contain contextual information about the error. This is often the field or value that triggered the error. Indicates whether the reported problem is fatal (an error) or is less-severe (a warning). eBay encountered a fatal error during the processing of the request, causing the request to fail. When eBay encounters an error, it returns error data instead of the requested business data. Inspect the error details and resolve the problem before resubmitting the request. eBay encountered a non-fatal error during the processing of the request, causing the request to fail. Inspect the warning details and resolve the problem before resubmitting the request. Reserved for internal or future use. Conditionally Reserved for internal or future use. Conditionally Reserved for internal or future use. Conditionally Reserved for internal or future use. Conditionally Reserved for internal or future use. Conditionally Base response container for all service operations. Contains error information associated with the request. A token representing the application-level acknowledgement code that indicates the response status (e.g., Success). The AckValue list specifies the possible values for Ack. Always Contains information for warnings or errors that occurred when eBay processed the request. Note: This field is not returned if the value of ack is Success. Conditionally The current version number of the Order Adjustment service. Always The date and time that the response was returned. Always This container is reserved for internal or future use. Conditionally Container consisting of the unique identifier for an eBay order. acceptAdjustment issueRefund rejectAdjustment Yes A unique identifier of an eBay order. This field will accept an eBay OrderID value (generated by eBay for multiple line item orders) or an OrderLineItemID value, which is a concatenation of ItemID and TransactionID with a hyphen separating these two IDs. For more information about eBay orders, see the Trading API documentation. acceptAdjustment issueRefund rejectAdjustment Yes The basic type for specifying monetary amounts. A double value (e.g., 1.00 or 1.0) is meaningful as a monetary amount when accompanied by a specification of the currency using the currencyId attribute. A code representing the currency of the specified monetary amount. This must be one of the currency code types that are currently valid for use on eBay. For more information about valid currency codes, see the Currency Code type table. issueRefund Yes Conditionally Indicates the charge component of an order line item to which a PriceLine applies. Note: Regardless of the charge component specified, the amount refunded applies to the total quantity of that line item in the order. For example, if the buyer ordered three units of a particular item, and the seller is refunding the shipping price of that item, the refund will comprise the total shipping price for all three units. issueRefund Yes The purchase price of the order line item. The shipping charge for the order line item. A miscellaneous additional amount that the seller wishes to apply to the order line item. The seller can use the note field to provide an explanation of the additional amount. Container for information about one charge component of an order line item, and the associated amount being refunded. The order line item charge component to which this priceLine applies. The PriceLineType list specifies the possible values for type. Note: Regardless of the type specified, the amount refunded applies to the total quantity of that line item in the order. For example, if the buyer ordered three units of a particular item, and the seller is refunding the shipping price of that item, the refund will comprise the total shipping price for all three units. issueRefund Yes The amount being refunded for the order line item charge component specified by the type field. Note: The value of the currencyId attribute of this field must be the same value for totalRefundAmount and all instances of lineItem.priceLine.refundAmount throughout this call, or the call will fail. issueRefund Yes Container for information about an item for which the seller is issuing a refund. For each item being refunded, this includes the order line item, the types of charges being refunded, and the amount for each. A unique identifier of an eBay order line item. This field will accept an OrderLineItemID value, which is a concatenation of ItemID and TransactionID with a hyphen separating these two IDs. Note: This field will not accept an eBay OrderID value (generated by eBay for multiple line item orders). For more information about eBay orders, see the Trading API documentation. issueRefund Yes Contains information about one charge component of an order line item, and the associated amount being refunded. Charge components include the purchase price, the shipping charge, and uncategorized additional amounts. The seller can specify just one or multiple priceLines for a given order line item. issueRefund Yes User details component Unique ebay identifier of the buyer Indicates the monetary source from which the refund was disbursed. issueRefund Conditionally The amount that the seller is due from eBay, defined as the Payout. It is the total amount for an order (including the purchase price and shipping charges) that the buyer pays. The seller's PayPal account. The seller's bank account that is registered with eBay. Information about the seller's source of funding for the refund. Note: This container is returned only if the value of refundStatus is Success. The monetary source from which the refund was made. The FundingSourceType list specifies the possible values for fundingSource. issueRefund Conditionally The seller's account number with the funding source. issueRefund Conditionally The total amount being refunded, in the currency specified by the currencyId attribute of this field. issueRefund Conditionally A string provided by the refund funding source (for example, the seller's bank or PayPal) identifying the disbursement transaction for the refund. Note: This field is returned only if the value of refundFundingSource.fundingSource is BankAccount or Paypal, and if the value of refundStatus is Success. issueRefund Conditionally Indicates the status of the refund transaction when issueRefundResponse is transmitted. issueRefund Always The refund was issued successfully. The refund is in progress, but has not yet completed. Note: This value can be returned for any funding source. Upon successful completion of the refund, the seller will receive a RefundSuccessful platform notification. For more information, see the <a href="http://developer.ebay.com/DevZone/XML/docs/Reference/eBay/types/NotificationEventTypeCodeType.html">NotificationEventTypeCodeType</a> page. The refund was not issued. Use the getVersion call to retrieve the current version number of the Order Adjustment service. This call can be used to monitor the service for availability. It has no input parameters and the response contains only the standard output fields.

Retrieves the current version of the Order Adjustment service.

[[ORG]] Default operation to return the version. Enables a seller to accept over or under payments from a buyer for a specified order.

Enables a seller to accept over or under payments from a buyer.

Contains information identifying the eBay order for which the refund will be issued. acceptAdjustment Yes [[ORG]] Return seller accepted over or under payment status. Enables a seller to reject over or under payments from a buyer for a specified order.

Enables a seller to reject over or under payments from a buyer.

Contains information identifying the eBay order for which the refund is being rejected. rejectAdjustment Yes [[ORG]] Return seller rejected over or under payment status. Enables a seller to voluntarily provide a refund to a buyer. The seller can refund the item price, the shipping cost or an additional amount for one or more line items in the order. Note: Currently, issueRefund may be applied to one order at a time.

Enables a seller to voluntarily provide a refund to a buyer.

The unique eBay user ID of the buyer to whom the refund is being issued. Because the required orderId.Id field provides information sufficient to determine the identity of the buyer, this field is not required. The seller can employ this field as a security measure, by independently providing the buyer's user ID to validate the buyer's identity against the user ID value derived from orderId.id. If the values do not match, this issueRefund call will fail. issueRefund No A unique identifier of the issueRefund request, created and maintained by the seller making the request. eBay uses externalReferenceId to distinguish this refund request from any others the seller submits for this or any other order. Example: <code>order12345_refundrequest67890</code>. 120 issueRefund Yes Contains information identifying the eBay order for which the refund is being issued. issueRefund Yes The basis on which the refund is being issued. Note: This optional field currently has one enumeration value, which is the default. issueRefund No The total amount being refunded with this call. This amount should be the total of all the lineItem.priceLine.refundAmount values specified with this call. Note: The value of the currencyId attribute must be the same for totalRefundAmount as for all instances of lineItem.priceLine.refundAmount throughout this call, or the call will fail. issueRefund Yes An optional message that the seller can provide to the buyer to explain any aspect of the refund being issued, such as the purpose of a lineItem.priceLine.type value of ADDITIONAL_AMOUNT. 500 issueRefund No Contains information about a single line item within an order for which the seller is issuing one or more refunds. The seller can specify as many line items as are being refunded from a single eBay order. issueRefund Yes [[ORG]] Return the status of voluntary refund, provide the details of the funding source for the refund and an estimated time. On failure provide url for sellers to take next action. An identifier generated by eBay for the transaction. Note: This field is returned only if the value of refundStatus is Success. issueRefund Conditionally The status of the refund transaction when issueRefundResponse is transmitted. The RefundStatus list specifies the possible values for refundStatus. issueRefund Always For some failures of this call, eBay provides this URL to a page on the eBay website, where the seller can take certain actions that will enable the refund processing to complete. Note: This field is returned only if the value of refundStatus is not Success, and an alternative payment method is available to the seller. issueRefund Conditionally Contains information about the seller's source of funding for the refund. Note: This container is returned only if the value of refundStatus is Success. issueRefund Conditionally If the refundStatus field value is Pending when issueRefundResponse is transmitted, the eBay refunds system uses estimatedCompletionDate to return an estimate of the date that the refund transaction will be complete. issueRefund Conditionally Indicates the basis on which the refund is being issued. issueRefund No The seller is issuing a refund without requiring the buyer to return the product. This is the default value of RefundType. Default operation to return the version. Allow seller to accept over or under payments from buyer for an order. Allow seller to reject over or under payments from buyer for an order. Allow sellers to refund voluntarily. Operation allows seller to refund either item_price, shipping and/or additional amount at item level and for all items within an order. Currently, it supports for one order at a time. 1.0.0