Mark Return Refund Sent

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

This method is used on behalf of the seller 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/return/{returnId}/mark_refund_sent

URI parameters

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,
    "exchangeRate": string,
    "value": number
    },
"refundDetail":
    { /* RefundDetailType */
    "donationAmount":
        { /* Amount */
        "convertedFromCurrency": string,
        "convertedFromValue": number,
        "currency": string,
        "exchangeRate": string,
        "value": number
        },
    "feeCreditAmount":
        { /* Amount */
        "convertedFromCurrency": string,
        "convertedFromValue": number,
        "currency": string,
        "exchangeRate": string,
        "value": number
        },
    "itemizedRefundDetail": [
        { /* ItemizedRefundDetailType */
        "refundAmount":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": number,
            "currency": string,
            "exchangeRate": string,
            "value": number
            },
        "refundFeeType": string,
        "restockingFeePercentage": string
        }
        /* More ItemizedRefundDetailType nodes here */
      ],
    "totalAmount":
        { /* Amount */
        "convertedFromCurrency": string,
        "convertedFromValue": number,
        "currency": string,
        "exchangeRate": string,
        "value": number
        }
    }
}

Request field descriptions

Output

See also Samples.

Payload model

This call has no response payload.

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.

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/5********4/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