Review Aftersales

API used to review (approve, reject, or offer alternatives to) a buyer's return request.

---

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

• AFTERSALES
• RMA | ^line_item_decisions |[]object |Y | |Decisions applied at the line item level. | ^^line_items |[]object |Y | |Line items for which this decision applies. Decision details apply to each line item individually (e.g. a partial refund amount of $1.00 for 3 line items will result in a total partial refund amount of $3.00). | ^^^return_line_item_id |string |Y |4035227657962164811 |Unique identifier for this item in the return. In the case of virtual bundle, this corresponds to the id of the original parent item bundle. | ^^^sub_return_line_item_id |string |N |4035227657962164815 |Unique identifier for this item in the return. In the case of virtual bundle, this corresponds to the id of the current child item being returned. | ^^action |string |Y |APPROVE_REQUEST |Action/decision to be applied. Possible values:
• APPROVE_REQUEST
• APPROVE_RETURN_PACKAGE
• REJECT_REQUEST
• REJECT_RETURN_PACKAGE
• REFUND_INSTEAD
• OFFER_PARTIAL_REFUND
• OFFER_PARTIAL_REFUND_AFTER_RECEIVING_PKG | ^^alternative_solution_details |object |N | |Details for an alternative resolution (if applicable). | ^^^partial_refund_amount |string |N |12.34 |Proposed refund amount. | ^^^currency |string |N |USD |Currency of the refund amount (ISO 4217). Must match the currency of the forward order. | ^^reason |object |N | |To justify the action/decision (generally required for rejection). | ^^^reason_id |string |N |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. | ^^^text |string |N |I have reached an agreement with the buyer |Additional explanation for the decision. | ^^^media |object |N | |Supporting evidence (such as images). | ^^^^uri |string |N |tos-maliva-i-o3syd03w52-us/57a1c8908fe74572861ea5e50887d8d1 |Image URI obtained from the Upload Product Image API. | ^^^^mime_type |string |N |image/png |MIME type of the media (such as image/jpeg). | ^action_unix_time |int |N |1774486592 |The timestamp at which the decision/action was made (in unix seconds). | ^idempotency_key |string |N |40b456b1-78e7-412d-9fe6-82181496e1bd&app_key=38abcd |The idempotency key is a unique value generated by the client which the server uses to recognize the same request. How you create unique keys is up to you, but we suggest using UUIDs, or another random string with enough entropy to avoid collisions. Idempotency keys can be up to 255 characters long. |

Query

https://open-api.tiktokglobalshop.com/return_refund/202606/aftersales/review?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY

Body

{"aftersales_request_decisions":[{"request_id":"4035319218955782461","request_id_type":"AFTERSALES","line_item_decisions":[{"line_items":[{"return_line_item_id":"4035227657962164811","sub_return_line_item_id":"4035227657962164815"}],"action":"APPROVE_REQUEST","alternative_solution_details":{"partial_refund_amount":"12.34","currency":"USD"},"reason":{"reason_id":"seller_reject_apply_package_has_not_exceeded_estimated_delivery_time","text":"I have reached an agreement with the buyer","media":{"uri":"tos-maliva-i-o3syd03w52-us/57a1c8908fe74572861ea5e50887d8d1","mime_type":"image/png"}}}],"action_unix_time":1774486592,"idempotency_key":"40b456b1-78e7-412d-9fe6-82181496e1bd\u0026app_key=38abcd"}]}

{"code":0,"data":{"errors":[{"code":"98001004","message":"Invalid parameters. Please verify your input before retrying"}]},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

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