接口说明

开发者通过本接口同步退款单的审核结果，同意/拒绝。
退款审核有时效，若开发者在退款单创建后72小时内未同步审核结果，则系统默认审核通过。
开发者调用接口发起退款/抖音客服主动退款是免审的，无需开发者审核。只有用户从平台入口发起，且本单对应规则及履约状态是需要审核时，才会需要开发者审核。因此，务必接入该接口。
根据业务规则，用户发起的退款在某些场景下需要审核，开发者可以通过退款申请回调的need_refund_audit字段/退款查询接口返回的merchant_audit_detail字段判断。

使用限制

无

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/trade_basic/v1/developer/refund_audit_callback/
HTTP Method	POST
Scope	trade_basic.developer.trade_refund
权限要求	无

请求参数

请求头

access-token必填String

示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

调用https://open.douyin.com/oauth/client_token/生成的token

content-type必填String

示例：application/json

固定值"application/json"

Body

refund_audit_status必填Int32

示例：2

审核状态，

1-同意退款
2-不同意退款

refund_id必填String

示例：1123

交易系统侧退款单号，长度 <= 64 byte

deny_messageString

示例：不同意退款

不同意退款信息(不同意退款时必填)，长度 <= 512 byt>

请求示例
curl --location --request POST 'https://open.douyin.com/api/trade_basic/v1/developer/refund_audit_callback/' \
--header 'Content-Type: application/json' \
--header 'access-token: clt.xxx' \
--data-raw='{
        "refund_id": "motb71237362",
        "refund_audit_status": 2,
        "deny_message": "不同意退款",
}'

响应参数

Body

err_msg必填String

示例：success

错误提示

err_no必填Int32

示例：0

错误码

log_id必填String

示例：2023010128382726

日志id，排查问题时使用

响应示例
正常响应示例异常响应示例
{
  "err_no": 0,
  "err_msg": "success",
  "log_id": "2022092115392201020812109511046"
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	10000	参数不合法：xxxx	对照错误提示和接口字段定义，修改请求
200	12001	操作过于频繁，请稍后再试	接口调用太频繁，请降低频次
200	13000	系统错误，请重试/不支持对该类退款单进行审核	系统错误，请重试：若多次重试仍然报错，请联系oncall 不支持对该退款类型进行审核：检查是退款单号是否属于交易basic系统
200	20000	退款单不存在	1. 若刚刚发起退款，系统有延迟，建议等几秒钟再重试 2. 请检查refund_id是否正确，refund_id与小程序app_id是否匹配。建议通过退款查询接口查询退款单是否存在
200	22006	本退款单免审,无需设置商家审核结果/退款单有前置流程进行中,请完成前置流程再同步审核结果/退款单已审核(审核通过/拒绝/超时自动审核通过)，无需再次同步	本退款单免审,无需设置商家审核结果：无需审核退款单有前置流程进行中,请完成前置流程再同步审核结果：请检查退款申请回调是否正确响应，正确响应回调后才能同步审核结果。退款单已审核(审核通过/拒绝/超时自动审核通过)，无需再次同步：退款单已审核过，无需再同步审核

常见问题

1.如何判断退款单的审核状态

A:查询退款接口查询退款信息，merchant_audit_detail.audit_status是审核状态，merchant_audit_detail.refund_audit_deadline 是审核的最后期限

2.商家未同步退款审核结果，为什么退款成功了

A：有一下两种情况：

a. 退款单无需审核

b. 退款审核有期限，默认是 72小时(从发起退款的时刻开始)，在退款申请回调/查询退款能获取到，商家需要在有效期内同步审核结果。有效期过后，系统将默认审核通过。

3.哪些退款单需要审核，哪些不需要审核

A：开发者/抖音客服发起退款无需审核；根据业务规则，用户发起退款在某些场景下需要审核，开发者可以通过退款申请回调的need_refund_audit字段/退款查询接口返回的merchant_audit_detail字段判断。

同步退款审核结果在线调试