用户申请退款
语法
tt.applyRefundLife(options)
使用限制
// 判断是否支持行applyRefundLife if (tt.canIUse("applyRefundLife")) { // do something }
参数说明
名称 | 类型 | 是否必填 | 描述 | 示例值 |
orderId | string | 是 | 抖音订单号 | |
refundInfo | Object | 是 | 退款信息 | |
itemOrderList | ItemOrderList[] | 否 | 退款 item 单信息 不传默认所有购买的sku都退 | |
needRefundDeliveryFee | boolean | 否 | 是否需要退配送费 不需要传,如果所有sku+打包费都退了,默认会连带退配送费 | |
needRefundPackFee | boolean | 推荐传 | 是否需要退打包费 不传默认不退打包费 | |
afterSaleType | int | 是 | 退货退款(1)、仅退款(3) 核销前退款,只能发起退货退款 | |
success | Function | 否 | 接口调用成功的回调函数 | |
fail | Function | 否 | 接口调用失败的回调函数 | |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | |
refundInfo
属性名 | 类型 | 默认值 | 必填 | 说明 |
reasonCode | number[] | 是 | 请参考下面表格 目前仅支持传入一个编码 | |
note | string | 否(reasonCode = 999 ,即其他时,必填) | 退款备注(退款备注字数不能超过200个) | |
applySource | enum | | 是 |
|
reasonCode 枚举
类型 | code | 退款原因描述 |
发货前仅退款 | 410 | 我不想要了 |
发货前仅退款 | 402 | 买错了/买多了/买少了 |
发货前仅退款 | 403 | 地址/电话填写错误 |
发货前仅退款 | 409 | 选错送达时间 |
发货前仅退款 | 406 | 商家缺货 |
发货前仅退款 | 407 | 商家联系我取消 |
发货前仅退款 | 505 | 超出配送范围 |
发货后 送达前退款 | 410 | 我不想要了 |
发货后 送达前退款 | 402 | 买错 了/买多了/买少了 |
发货后 送达前退款 | 403 | 地址/电话填写错误 |
发货后 送达前退款 | 409 | 选错送达时间 |
发货后 送达前退款 | 712 | 骑手联系我取消 |
送达后退款 | 410 | 七天无理由退款 |
ItemOrderList
字段名 | 类型 | 是否必传 | 描述 |
itemOrderId | string | 是 | 退款的商品单号 |
回调成功
object 类型
属性名 | 类型 | 说明 |
orderId | string | 内部商户订单号 |
refundId | string | 内部退款单号 |
回调失败
object 类型
属性名 | 类型 | 是否一定存在 | 说明 |
errNo | string | 是 | 错误码,全部信息可查看 errNo 说明
|
errMsg | string | 是 | 错误信息提示 |
errLogId | string | 是 | 当申请退款接口失败时会提供该数据,可供服务端排查问题 |