抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
基本信息
请求参数
Header:
参数名称
参数类型
必须参数
备注
» content-type
string
必填
application/json
» access-token
string
必填
​
Body:
参数名称
参数类型
必须参数
备注
» account_id
string
必填
账户id
» order_id
string
必填
抖音订单id
» order_out_id
string
选填
外部订单id
» out_after_sale_id
string
必填
三方售后单id
» refund_list
list<trade/common/biz_common.RefundInfo>
必填
​
»» order_item_id
string
必填
跟创单的item单id一致,主单itemId必填
配送费无需指定,抖音自行处理;
打包费id无需填入,只需要给到item_type=3
»» item_type
​
enum(trade/common/biz_common.RefundItemTypeEnum)
必填
1=商品
2=配送费
3=打包费
» refund_reason
int
必填
​
退款原因
​
// 联系不上用户 = 524
// 商品缺货/无货 = 715
// 商家已打样 = 405
// 商家订单太多忙不过来 = 162
// 超出配送范围 = 505
// 没有配送员接单 = 506
// 商家未接单取消 = 906
// 商品质量问题 = 1611
// 大小/尺寸/质量与商品描述不符 = 643
// 商品腐烂/变质 = 1614
// 包装/商品破损 = 515
// 商品过期 = 1615
// 商品化冻/融化 = 1616
// 与用户协商一致退款 = 1617
// 其他理由 = 999
» handle_time
int
必填
时间戳,秒
» operator_id
string
选填
操作人id
» operator_name
string
选填
操作人名称
» merchant_desc
string
选填
商家备注
» after_sale_type
int
必填
​
退货退款(1)
仅退款(3)
核销前退款,只能发起退货退款
» apply_source
int
​
必填
const (
// 商家核销前退款
ApplySourceEnum_MerchantBeforeFulfil ApplySourceEnum = 102
// 商家核销后退款
ApplySourceEnum_MerchantAfterFulfil ApplySourceEnum = 310
)
注意用户发起,商户发起值不同
json示例
{ "order_id": "fnSzfoNz82", "order_out_id": "0BdwlE5DnP", "refund_reason": 76, "operator_id": 4389325350350326656, "operator_name": "NL5tvV0WGT", "merchant_desc": "j0LL06MoYS", "refund_list": [ { "order_item_id": "QeWiMXboU7", "item_type": 2 } ] }
返回参数
Body:
参数名称
参数类型
必须参数
备注
» Extra
object(common/openapi_common.ExtraBody)
选填
​
»» logid
string
必填
​
»» now
int
必填
​
»» error_code
int
必填
​
»» description
string
必填
​
»» sub_error_code
int
必填
​
»» sub_description
string
必填
​
» data
object(trade/biz_openapi/biz_openapi.DeliveryOrderApplyRefundResponseData)
必填
​
»» order_id
string
必填
​
»» after_sale_id
string
必填
​
»» success
bool
必填
​
json示例
{ "data": { "order_id": "1HqK6nfdOR", "success": false }, "Extra": { "logid": "tDvF6YRdJV", "now": 5109029405089483143, "error_code": 44789761, "description": "BaxIoupRPy", "sub_error_code": 985428888, "sub_description": "fOTuicmRht" } }