eBay Post-Order APIVersion 2

Mark Return Refund Sent

POST /post-order/v2/return/{returnId}/mark_refund_sent

The seller uses this call to notify eBay and the buyer that a refund has been issued.

Input

See also Samples.

Resource URI (production)

POST https://api.ebay.com/post-order/v2/post-order/v2/return/{returnId}/mark_refund_sent

URI parameters

Parameter Type Required? Meaning
returnId string Required The unique identifier of the return. The returnId value is required to identify the return for which the refund was issued.


HTTP request headers

All requests made to eBay REST operations require you to provide the authorization HTTP header for authentication.
See HTTP request headers for details.



Authorization

This call uses standard authorization tokens. See Making a Call for details.

Payload model

The following lists all fields that could be included in the request.

{ /* MarkRefundSentRequest */
"comments": string,
"partialRefundAmount":
    { /* Amount */
    "convertedFromCurrency": string,
    "convertedFromValue": number,
    "currency": string,
    "value": number
    },
"refundDetail":
    { /* RefundDetailType */
    "itemizedRefundDetail": [
        { /* ItemizedRefundDetailType */
        "refundAmount":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": number,
            "currency": string,
            "value": number
            },
        "refundFeeType": string,
        "restockingFeePercentage": string
        }
        /* More ItemizedRefundDetailType nodes here */
      ],
    "totalAmount":
        { /* Amount */
        "convertedFromCurrency": string,
        "convertedFromValue": number,
        "currency": string,
        "value": number
        }
    }
}

Request field descriptions



Input Container/Field Type Occurrence Meaning
comments string Optional This optional string field allows the seller to communicate any details about the refund being issued.
partialRefundAmount Amount Conditional This field is conditionally required if the buyer and seller agreed upon a partial refund to settle the case. This amount is the dollar value of the partial refund.
partialRefundAmount
  .convertedFromCurrency
string Conditional This field indicates the currency involved in a monetary transaction before a price conversion was performed. Generally, this is the currency used by the buyer. This field is only applicable if a price conversion was necessary, and a price conversion is generally necessary if the buyer and seller are using different forms of currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
partialRefundAmount
  .convertedFromValue
number Conditional This value is the dollar amount of the currency involved in a monetary transaction before a price conversion was performed. This field is only applicable if a price conversion was necessary, and a price conversion is generally necessary if the buyer and seller are using different forms of currency.
partialRefundAmount.currency string Conditional This field indicates the currency involved in a monetary transaction. Generally, this is the currency used by the listing site's country.

Applicable values are from CurrencyCodeEnum:See currency.
partialRefundAmount.value number Conditional The dollar value of the currency specified in the currency field. The value of currency defaults to the standard currency used by the country of the listing site.
refundDetail RefundDetailType Required This container is used to specify the total amount of the refund, as well as an itemizedRefundDetail container for each refund type (refund on purchase price, refund on original shipping, or any other costs paid by the buyer). The amount(s) in the itemizedRefundDetail.amount field(s) should equal the amount in the refundDetail.totalAmount field.
refundDetail
  .itemizedRefundDetail
array of ItemizedRefundDetailType Required This container is used to declare a refund that is being issued, or has been issued to the buyer. An itemizedRefundDetail container is required for each different refund type, such as purchase price and original shipping. This container is required when using the POST /post-order/v2/return/{returnId}/issue_refund call to issue a refund, or when using the POST /post-order/v2/return/{returnId}/mark_refund_sent call to mark a refund as sent. In the POST /post-order/v2/return and GET /post-order/v2/return/{returnId} calls, this container will be returned under the actualRefund container if a refund has occurred.
refundDetail
  .itemizedRefundDetail
  .refundAmount
Amount Required This dollar value is the amount of the refund for the particular refund type (specified in the refundFeeType field). When issuing a refund through the POST /post-order/v2/return/{returnId}/issue_refund call, or if marking a refund as sent with the POST /post-order/v2/return/{returnId}/mark_refund_sent call, the seller must use a separate itemizedRefundDetail container for each refund type, such as one for the purchase price, one for original shipping, and one for a restocking fee (if applicable).
refundDetail
  .itemizedRefundDetail
  .refundAmount
  .convertedFromCurrency
string Conditional This field indicates the currency involved in a monetary transaction before a price conversion was performed. Generally, this is the currency used by the buyer. This field is only applicable if a price conversion was necessary, and a price conversion is generally necessary if the buyer and seller are using different forms of currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
refundDetail
  .itemizedRefundDetail
  .refundAmount
  .convertedFromValue
number Conditional This value is the dollar amount of the currency involved in a monetary transaction before a price conversion was performed. This field is only applicable if a price conversion was necessary, and a price conversion is generally necessary if the buyer and seller are using different forms of currency.
refundDetail
  .itemizedRefundDetail
  .refundAmount.currency
string Conditional This field indicates the currency involved in a monetary transaction. Generally, this is the currency used by the listing site's country.

Applicable values are from CurrencyCodeEnum:See currency.
refundDetail
  .itemizedRefundDetail
  .refundAmount.value
number Conditional The dollar value of the currency specified in the currency field. The value of currency defaults to the standard currency used by the country of the listing site.
refundDetail
  .itemizedRefundDetail
  .refundFeeType
string Required This enumerated value indicates the type of refund. When issuing a refund through the POST /post-order/v2/return/{returnId}/issue_refund call, or if marking a refund as sent with the POST /post-order/v2/return/{returnId}/mark_refund_sent call, the seller must use a separate itemizedRefundDetail container for each refund type, such as one for the purchase price, one for original shipping, and one for a restocking fee (if applicable).

Applicable values are from RefundFeeTypeEnum:See refundFeeType.
refundDetail
  .itemizedRefundDetail
  .restockingFeePercentage
string Conditional Indicates the restocking fee (as a percentage of the purchase price) charged by the seller for returned items. In order to charge the buyer a restocking fee when an item is returned, a US seller must input a restocking fee value as part of the return policy.

To obtain the list of applicable values, call GeteBayDetails of the Trading API with the DetailName field value set to ReturnPolicyDetails. Then look for the list of restocking fee value options in the ReturnPolicyDetails.RestockingFeeValue container in the response.

This field is only applicable (and necessary to include in the request payload) if the refundFeeType value is RESTOCKING_FEE.
refundDetail.totalAmount Amount Required This value is the total cumulative amount of the refund issued to the buyer. This value should equal the sum of the values in the itemizedRefundDetail.refundAmount field(s). This container is required when using the POST /post-order/v2/return/{returnId}/issue_refund call to issue a refund, or when using the POST /post-order/v2/return/{returnId}/mark_refund_sent call to mark a refund as sent. In the POST /post-order/v2/return and GET /post-order/v2/return/{returnId} calls, this container will be returned under the actualRefund container if a refund has occurred.
refundDetail.totalAmount
  .convertedFromCurrency
string Conditional This field indicates the currency involved in a monetary transaction before a price conversion was performed. Generally, this is the currency used by the buyer. This field is only applicable if a price conversion was necessary, and a price conversion is generally necessary if the buyer and seller are using different forms of currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
refundDetail.totalAmount
  .convertedFromValue
number Conditional This value is the dollar amount of the currency involved in a monetary transaction before a price conversion was performed. This field is only applicable if a price conversion was necessary, and a price conversion is generally necessary if the buyer and seller are using different forms of currency.
refundDetail.totalAmount
  .currency
string Conditional This field indicates the currency involved in a monetary transaction. Generally, this is the currency used by the listing site's country.

Applicable values are from CurrencyCodeEnum:See currency.
refundDetail.totalAmount.value number Conditional The dollar value of the currency specified in the currency field. The value of currency defaults to the standard currency used by the country of the listing site.

Output

See also Samples.

Payload model

This call has no response payload.

null



Samples

New to making API calls? Please see Making a Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Sample: Mark a Refund Sent

Communicate to the buyer that the refund has been sent.

Description

With this operation, the seller can notify the buyer that a refund has been sent for the specified return, and provide a breakdown of the costs being refunded.

Input

The returnId parameter is required to identify the return for which the refund was sent. In this request, there are two amounts being refunded: The purchase price of AUD 40.00 and the corresponding original shipping cost of AUD 3.10. The totalAmount container provides the sum of those two values (AUD 43.10).

URL format. See also the non-wrapped version of this URL.

POST https://api.sandbox.ebay.com/post-order/v2/return/5000121144/mark_refund_sent
{ 
  "refundDetail":
  { 
    "itemizedRefundDetail": [
      {
        "refundAmount":
        { 
          "currency": "AUD",
          "value": "40.0"
        },
        "refundFeeType": "PURCHASE_PRICE",
        "restockingFeePercentage": "0"
      },
      { 
        "refundAmount":
        { 
          "currency": "AUD",
          "value": "3.1"
        },
        "refundFeeType": "ORIGINAL_SHIPPING",
        "restockingFeePercentage": "0"
      }
    ],
    "totalAmount":
    { 
        "currency": "AUD",
        "value": "43.1"
    }
  }
}

Output

A successful call returns an HTTP code of 200; there is no payload for the response.

JSON format.



Change History

Change Date Description