创建退款退货申请
请求 URLPOST系统级输入参数
应用级输入参数
| 名称 | 类型 | 是否必须 | 描述 | 示例值 | |
|---|---|---|---|---|---|
| orderId | Long | 是 | 主订单 | ||
| orderEntryIds | Long[] | 是 | 子订单 | ||
| disputeRequest | String | 是 | 退款/退款退货。只有已收到货，才可以选择退款退货。 | 退款:"refund"; 退款退货:"returnRefund" | |
| applyPayment | Long | 是 | 退款金额（单位：分）。不大于实际付款金额；等待卖家发货时，必须为商品的实际付款金额。 | ||
| applyCarriage | Long | 是 | 退运费金额（单位：分）。 | ||
| applyReasonId | Long | 是 | 退款原因id（从API getRefundReasonList获取） | ||
| description | String | 是 | 退款申请理由，2-150字 | ||
| goodsStatus | String | 是 | 货物状态 | 售中等待卖家发货:"refundWaitSellerSend"; 售中等待买家收货:"refundWaitBuyerReceive"; 售中已收货（未确认完成交易）:"refundBuyerReceived" 售后未收货:"aftersaleBuyerNotReceived"; 售后已收到货:"aftersaleBuyerReceived" | |
| vouchers | String[] | 否 | 凭证图片URLs。1-5张，必须使用API uploadRefundVoucher返回的“图片域名/相对路径” | [https://cbu01.alicdn.com/img/ibank/2019/901/930/11848039109.jpg] | |
| orderEntryCountList | alibaba.ocean.openplatform.biz.trade.common.model.OrderEntryCountModel[] | 否 | 子订单退款数量。仅在售中买家已收货（退款退货）时，可指定退货数量；默认，全部退货。 | [{"id":586683458996743215,"count":1}] |
返回结果
| 名称 | 类型 | 描述 | 示例值 | |
|---|---|---|---|---|
| result | alibaba.ocean.openplatform.common.OrderRefundCreateResult | 返回结果 | {"result":{"result":{"refundId":"TQ34931008034741532"},"success":true}} |
错误码
| 错误码 | 错误描述 | 解决方案 | |
|---|---|---|---|
| 5001 | 订单不存在 | - | |
| 5002 | 订单买家与用户身份不一致 | - | |
| 5003 | 货物状态状态不合法 | 参考goodsStatus示例 | |
| 5004 | 退款退货原因错误，请确认原因id | 使用API alibaba.trade.getRefundReasonListI查找合法的参数 | |
| 5005 | 需要上传凭证 | 部分退款原因需要强制上传凭证 | |
| 5006 | 退运费大于0 | 部分退款原因不退运费 | |
| 5010 | 退货状态错误 | 请确认订单是否支持能够退款，以及输入参数是否合法： 1.退款退货（已收到货的情况下，才能退款退货） 2.货物状态是否与订单状态一致（是否发货、是否售中） 3.检查子订单id、订单状态、是否重复提交等 | |
| 5011 | 退款金额错误 | 不大于实际付款金额 | |
| 5012 | 退款描述长度错误 | - | |
| 5013 | 子订单退货数量 | 仅在售中买家已收货退款退货时，可以指定小于全部。在全部退货的情况下，推荐不填写，使用默认值。 | |
| 5100 | 其他未知错误 | 请确认订单是否可申请退款，按照示例填写参数 | |
| 4xxx | 服务方内部错误 | - |
输入示例
orderId:506683458994743225 orderEntryIds:[506683458996743225] disputeRequest:returnRefund applyPayment:1 applyCarriage:0 applyReasonId:20028 description:测试 goodsStatus:refundBuyerReceived vouchers: orderEntryCountList:[{"id":506683458996743225,"count":1}]
售后、售中的区别： 交易完成前，为售中；交易完成后，为售后。一般情况，点击确认收货，交易完成。特殊情况，如：赊账、物流未签收等，视为售中或者不支持退款退货。 售中收到货、售后未收到货： 售中收到货的典型场景是卖家已发货买家未确认收货。此时，买家退货可以选择售中收到货，才能支持退款。 售后未收到货是防止买家确认收货，但实际未收货的情况。
推荐
-
-
QQ空间
-
新浪微博
-
人人网
-
豆瓣
