开发者发起退款
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/apps/trade/v2/refund/create_refund
使用限制
接口说明
退款流程
退款说明
错误码
| 错误码 | 错误提示 | 建议解决方案 |
|---|---|---|
| 10000 | 参数不合法：(ots72128388728472)商品单不存在 | 按以下步骤排查： 检查item_order_id是否正确，注意是item_order_id，不是商户单id 检查out_order_no与item_order_id是否匹配。用查询券状态接口查询商户单下的所有item列表，检查item_order_id是否在列表中。 |
| 20000 | 订单不存在 | 检查out_order_no是否正确，out_order_id与appid是否匹配 |
| 22000 | 订单状态不支持退款 | 请检查订单状态：订单未支付或已关闭则不允许再发起退款 |
| 22001 | (ots7218277338394847)商品单状态不支持退款 | 订单item子单的状态不允许发起退款，用查询券状态接口查询item单的状态： item处于[退款中,退款完成]状态时，不允许退款 预约类的item，处于[退款中,退款完成,预约中]状态时不允许退款。 下单即预约(门票)的item，预约中不允许退款，可以取消预约后发起退款 先买后约(预售券)的item，预约中/预约成功状态不允许退款，可以取消预约或者等预约完成时间过后，item变为已核销状态后，再发起退款 |
| 22002 | 无可退款的商品单 | 订单下所有的item处于不可退状态时，无法发起退款，参考22001的说明 |
| 22004 | 外部退款单号重复了 | 开发者生成的外部退款单号以前已经用过了，请重新生成 |
| 22006 | 退款单状态不允许设置商家审核结果 | 退款审核状态前置步骤未完成，等几分钟后再重新发起 |
| 22007 | 超出单次最大可退款的商品数量 | 一般是单次退款item订单的数量超过了100 |
| 22008 | 退款商品数量超过可退款的商品数量 | 用户可以发起退款的item单数小于请求数 |
| 22009 | 不支持同时发起核销前和核销后退款 | 发起退款的item单列表中包含已核销和未核销的，需要分别发起退款 |
| 22012 | 退款来源不支持退款 | 退款来源有: 用户,开发者 |
| 22014 | 订单有其他退款申请正在进行中，不支持发起退款申请 |
Q&A
1.如何判断订单是否在退款中/已退款
2.为什么一直处于退款中
1.
1.
1.
2.
3.
3.如何判断退款单的审核状态
4.商家未同步退款审核结果，为什么退款成功了
5.哪些退款单需要审核，哪些不需要审核
6.退款审核/退款查询接口报错，订单不存在是什么原因
1.
2.
7.为什么开发者未发起退款，但是收到了退款申请回调/查询到订单处于退款中
8.为什么订单会存在抖音客服发起的退款
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/trade/v2/refund/create_refund' \
--header 'access-token: clt.xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"out_order_no": "123123131",
"out_refund_no": "123123",
"cp_extra": "extra_info",
"order_entry_schema": {
"path": "page/xxx",
"params": "{\"id\":1}"
},
"notify_url": "https://xxx",
"item_order_detail": [
{
"item_order_id": "xxx"
}
],
"times_card_refund_param":{
"times_card_refund_type": 1
}
}'响应示例响应示例
{
"data": {
"error_code": 0,
"description": "success",
"refund_id": "ot12312312"
},
"extra": {
"sub_error_code": 0,
"sub_description": "success",
"logid": "2022092115392201020812109511046",
"now": 1663745962686,
"error_code": 0,
"description": "success"
}
}请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
access-token
string
必需
示例值:
clt.xxx
Body 参数application/json