eBay Post-Order APIVersion 2

Close case

POST /post-order/v2/casemanagement/{caseId}/close

This call lets buyers close an open case. Buyers can close an INR case after the item arrives, and they might close a Return case if they decide to keep the item, or have otherwise worked out transaction with the seller.

Input

See also Samples.

Resource URI (production)

POST https://api.ebay.com/post-order/v2/casemanagement/{caseId}/close

URI parameters

Parameter Type Required? Meaning
caseId string Required The unique identifier of a case. This URI parameter is required in order to identify the case that is being closed. The case is identified by the caseId that is passed in as part of the call URI.


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.

{ /* BuyerCloseCaseRequest */
"closeReason": token,
"comments":
    { /* Text */
    "content": string,
    "language": string,
    "translatedFromContent": string,
    "translatedFromLanguage": string
    }
}

Request field descriptions



Input Container/Field Type Occurrence Meaning
closeReason token Required This field is used to provide a reason why the buyer is closing the case. One of the values in the BuyerCloseReasonEnum type must be used. If the OTHER value is passed in, the buyer should use the comments container to provide some more details on why the case is being closed.

Applicable values: See BuyerCloseReasonEnum
comments Text Optional This optional container is used if the buyer wants to provide more details on why the case is being closed.
comments.content string Conditional This field displays the actual textual content in the language specified in the language field. This field is always used for containers using the Text type.
comments.language string Conditional This two-letter code indicates the language used to display the content in the content field. The language will default to the language used on the eBay site if a specific language is not specified through the Accept-Language HTTP header. This field is always used for containers using the Text type.

Applicable values are from LanguageEnum:See language.
comments.translatedFromContent string Conditional If language translation/localization is required, this field displays the actual textual content in the language specified in the translatedFromLanguage field. If language translation was not required, this field is not applicable.
comments
  .translatedFromLanguage
string Conditional If language translation/localization is required, this two-letter code indicates the language used to display the content in the translatedFromContent field. If language translation was not required, this field is not applicable.

Applicable values are from LanguageEnum:See translatedFromLanguage.

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.

Sample: Basic Call

Closing a case

Description

This call allows a buyer or seller to close a case before eBay customer support makes a decision on the case. In this particular sample, it is the buyer that is closing an INR case after finally receiving the item from the seller.

Input

The buyer passes in the case ID value as a path parameter to identify the case that is being closed. The closeReason field is required and the seller's reason for closing the case is ITEM_ARRIVED. The buyer also includes the optional comments container to provide a little more detail.

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

POST https://api.ebay.com/post-order/v2/casemanagement/{caseId}/close
{ 
"closeReason": "ITEM_ARRIVED",
"comments":
    { 
    "content": "I am closing the case because the item has arrived."
    }
}

Output

There is no output payload with this response. A successful call contains an HTTP status code of 200.

JSON format.



Change History

Change Date Description