Get Decision Eligibility

GET

/return_refund/202601/decision_eligibility

Use this API to evaluate which seller decisions are currently allowed for the specified aftersales request. The API returns one result per requested decision, including whether the decision is currently eligible and any rejection reasons that are applicable for an eligible reject decision.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

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

return_or_cancel_id

required

string

The TikTok Shop return or cancellation request ID to evaluate. Pass the request identifier for the target cancellation, refund, return, or other supported aftersales flow. Do not pass an order ID or order line ID in this field.

check_decisions

Array<string>

Allowed values: APPROVE_REQUEST_CANCEL APPROVE_REFUND APPROVE_RETURN APPROVE_RECEIVED_PACKAGE APPROVE_REPLACEMENT ISSUE_REPLACEMENT_REFUND DIRECT_REFUND REJECT_REQUEST_CANCEL REJECT_REFUND REJECT_RETURN REJECT_RECEIVED_PACKAGE REJECT_REPLACEMENT ISSUE_EXCHANGE_REFUND

The seller decisions to evaluate for the specified aftersales request. Possible Values:

• APPROVE_REQUEST_CANCEL
• APPROVE_REFUND
• APPROVE_RETURN
• APPROVE_RECEIVED_PACKAGE
• APPROVE_REPLACEMENT
• ISSUE_REPLACEMENT_REFUND
• DIRECT_REFUND
• REJECT_REQUEST_CANCEL
• REJECT_REFUND
• REJECT_RETURN
• REJECT_RECEIVED_PACKAGE
• REJECT_REPLACEMENT -ISSUE_EXCHANGE_REFUND Note: When omitted, the API evaluates all supported seller decisions for the request and returns one result per decision.

locale

string

The BCP-47 locale codes for displaying the return reason, delimited by commas. Default: en-US Refer to Locale codes for the list of supported locale codes.

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

decisions

The seller-decision eligibility results for the specified aftersales request.

Array<object>

object

decision

One eligibility result for one evaluated seller decision. Possible Values:

• APPROVE_REQUEST_CANCEL
• APPROVE_REFUND
• APPROVE_RETURN
• APPROVE_RECEIVED_PACKAGE
• APPROVE_REPLACEMENT
• ISSUE_REPLACEMENT_REFUND
• DIRECT_REFUND
• REJECT_REQUEST_CANCEL
• REJECT_REFUND
• REJECT_RETURN
• REJECT_RECEIVED_PACKAGE
• REJECT_REPLACEMENT -ISSUE_EXCHANGE_REFUND

string

Allowed values: APPROVE_REQUEST_CANCEL APPROVE_REFUND APPROVE_RETURN APPROVE_RECEIVED_PACKAGE APPROVE_REPLACEMENT ISSUE_REPLACEMENT_REFUND DIRECT_REFUND REJECT_REQUEST_CANCEL REJECT_REFUND REJECT_RETURN REJECT_RECEIVED_PACKAGE REJECT_REPLACEMENT ISSUE_EXCHANGE_REFUND

eligible

Whether this seller decision is currently eligible for the specified aftersales request. true means eligible; false means ineligible.

boolean

ineligible_code

The reason code for an ineligible decision. This field is returned when eligible is false.

integer format: int64

ineligible_reason

The reason for an ineligible decision. This field is returned when eligible is false.

string

available_reject_reasons

The reject reasons available for an eligible reject decision. Each reason includes a name and localized display text.

Array<object>

object

name

The machine-readable name of the rejection reason to pass as the rejection-reason identifier in the applicable review or reject request.

string

text

The display text for the rejection reason.

string

Example

{
  "code": 0,
  "data": {
    "decisions": [
      {
        "decision": "APPROVE_REFUND",
        "eligible": true,
        "ineligible_code": 25001001,
        "ineligible_reason": "the return is already completed, you can't approve again.",
        "available_reject_reasons": [
          {
            "name": "seller_reject_apply_product_has_been_packed",
            "text": "Product shipped. Tracking updates will be available soon."
          }
        ]
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}