Reject Cancellation

POST

/return_refund/202309/cancellations/{cancel_id}/reject

Use this API to reject a buyer’s cancellation request for the specified cancel_id. Before calling this API, make sure the request is still in a state where seller rejection is currently allowed.

Authorizations

• accessToken

Parameters

Path Parameters

cancel_id

required

string

The cancellation request ID to reject. Use the cancel_id returned by Search Cancellations. Do not pass the order ID here.

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

idempotency_key

string

<= 255 characters

The idempotency key is a unique value generated by the client that the server uses to recognize the same request. Reuse the same key for every retry of that request. If you omit this parameter, the server generates a key for the individual request. You may choose your own method of creating unique keys. We suggest using UUIDs, or another random string with enough entropy, to avoid collisions. Idempotency keys can be up to 255 characters long.

Request Body^required

Media typeapplication/json

object

reject_reason

required

Seller’s reason for rejecting the buyer’s order cancellation request. Use the Get Decision Eligibility endpoint to retrieve the currently available rejection reasons for the same cancellation request, and submit the returned rejection reason name in this field.

string

comment

Seller’s comment on rejection decision. This is where a seller will provide more information about rejecting the request.

string

images

List of images provided by the seller to support seller’s decision to reject the order cancellation request.

Array<object>

object

image_id

required

Image ID.

string

mime_type

MIME type.

string

height

Image height. Unit: px

integer format: int64

width

Image width. Unit: px

integer format: int64

Example

{
  "reject_reason": "seller_reject_apply_product_has_been_packed",
  "comment": "I have packed the products before cancellation request",
  "images": [
    {
      "image_id": "tos-maliva-i-o3syd03w52-us/57a1c8908fe74572861ea5e50887d8d1",
      "mime_type": "image/png",
      "height": 200,
      "width": 200
    }
  ]
}

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

Example

{
  "code": 0,
  "data": {},
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}