Reject Return

Use this API to reject a buyer's return or refund request. The valid decision depends on the current request type and status. Before calling this API, make sure the request is still awaiting the seller action that matches the decision you send.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

• REJECT_REFUND: seller reject a refund-only request
• REJECT_RETURN: seller reject the initial return-and-refund request
• REJECT_RECEIVED_PACKAGE: seller reject return-and-refund request after the buyer has already shipped or handed over the item.
• REJECT_REPLACEMENT: seller reject replacement request
• OFFER_PARTIAL_REFUND_AFTER_RECEIVING_PKG: seller offer partial refund regarding to the package item quality check | reject_reason |string |Y |seller_reject_apply_package_has_not_exceeded_estimated_delivery_time |Seller's reason for rejecting the aftersales request. Use the Get Decision Eligibility endpoint to retrieve the currently available rejection options for the same request, and submit the returned rejection reason name in this field. Note: The available decisions and rejection reasons can change depending on the current request status, so fetch eligibility again before calling this API. | comment |string |N |I have reached an agreement with the buyer |Seller's comment on the rejection decision. This is where a seller will provide more information about rejecting the request. | images |[]object |N | |List of images provided by the seller to support their decision to reject the return request. | ^image_id |string |Y |tos-maliva-i-o3syd03w52-us/57a1c8908fe74572861ea5e50887d8d1 |Image URI obtained from the Upload Product Image API. | ^mime_type |string |N |image/png |MIME type. | ^height |int |N |200 |Image height Units: px | ^width |int |N |200 |Image width Units: px | partial_refund_amount |object |N | |Partial Refund Info for OFFER_PARTIAL_REFUND_AFTER_RECEIVING_PKG Decision | ^partial_refund_total |string |N |4.66 |Partial Refund Amount | ^currency |string |N |USD |Country Currency |

Query

https://open-api.tiktokglobalshop.com/return_refund/202606/returns/4035319218955782461/reject?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY&idempotency_key=40b456b1-78e7-412d-9fe6-82181496e1bd

Body

{"decision":"REJECT_RECEIVED_PACKAGE","reject_reason":"seller_reject_apply_package_has_not_exceeded_estimated_delivery_time","comment":"I have reached an agreement with the buyer","images":[{"image_id":"tos-maliva-i-o3syd03w52-us/57a1c8908fe74572861ea5e50887d8d1","mime_type":"image/png","height":200,"width":200}],"partial_refund_amount":{"partial_refund_total":"4.66","currency":"USD"}}

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

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code