eBay Post-Order APIVersion 2.7.1

Confirm Refund Received

POST /post-order/v2/cancellation/{cancelId}/confirm

This is a buyer-side method that you can use to indicate that the buyer received refund for the specified order cancellation.

In the case of unpaid order, this call can also be used by the buyer to acknowledge the order has been canceled and that the cancellation request has been closed.


See also Samples.

Resource URI (production)

POST https://api.ebay.com/post-order/v2/cancellation/{cancelId}/confirm

URI parameters

Parameter Type Required? Meaning
cancelId string Required The unique eBay-assigned identifier of the cancellation/refund being confirmed.

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.


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.

{ /* ConfirmRefundRequest */
    { /* DateTime */
    "formattedValue": string,
    "value": datetime
"unpaidOrder": boolean

Request field descriptions

Input Container/Field Type Occurrence Meaning
refundDate DateTime Conditional The date and time the refund was received. This container is ignored if the unpaidOrder field is set to true.

You must populate this field if a refund has been issued.
refundDate.formattedValue string Optional Reserved for future use.
refundDate.value datetime Conditional The date and time defining the start or end of an action or event.

The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock.

Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z
Example: 2020-08-20T00:00:00.000Z
unpaidOrder boolean Conditional If set to true, the canceled order was never paid for by the buyer and the buyer is not eligible for a refund. When true, the refundDate field is not applicable.


See also Samples.

Payload model

This call has no response payload.



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: Confirm a refund

Buyer confirms receipt of a refund.


The buyer uses this call to confirm they received the refund associated with a cancellation request.


There is no payload with this request. Supply the cancellation ID as a path parameter in the call.

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

POST https://api.ebay.com/post-order/v2/cancellation/5********7/confirm


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

JSON format.

Change History

Change Date Description