alibaba.damai.mz.order.refund.apply (订单退单申请API)

麦座-自建电商网站-订单退单申请API; 1、对麦座订单进行申请退票

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param OrderApplyRefund4cParam 可选 申请退单入参
  • └ refund_type
  • Number
  • 必须
  • 0
  • 退单方式;0=整单退单;1=部分退单。
  • └ mz_order_id
  • String
  • 必须
  • 80950450015203
  • 麦座订单号
  • └ apply_remark
  • String
  • 必须
  • 客户退票
  • 申请退单备注
  • └ express_refund_money_fen
  • Number
  • 可选
  • 1000
  • 配送费金额;以分为单位;若有多次部分退票时,所有的配送费金额总和,不能超过订单的原始配送费金额。
  • └ ticket_code_no_list
  • String []
  • 可选
  • 123456,1241415
  • 票单号列表;refundType=1时,非空。
  • └ ticket_refund_money_fen
  • Number
  • 必须
  • 20000
  • 退单金额;以分为单位。
  • └ external_refund_order_no
  • String
  • 必须
  • 15678456466
  • 外部申请退单流水号;每次退票申请需保证退单流水号的唯一性,同一个外部退单流水号的请求会做幂等处理;若有多次部分退票时 需每次传递不同的外部退单号。

响应参数

名称 类型 示例值 描述
result ResultData api返回结果
  • └ msg
  • String
  • 成功
  • 提示
  • └ code
  • String
  • 200
  • 状态码
  • data
  • OrderRefund4cVo
  • 麦座退单信息
  • └ mz_refund_order_id
  • String
  • 81020070015203
  • 麦座退单号
  • └ mz_order_id
  • String
  • 80950450015203
  • 麦座订单号
  • └ external_refund_order_no
  • String
  • 15678456466
  • 外部申请退单流水号
  • └ success
  • Boolean
  • true
  • api请求是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzOrderRefundApplyRequest req = new AlibabaDamaiMzOrderRefundApplyRequest();
AlibabaDamaiMzOrderRefundApplyRequest.OrderApplyRefund4cParam obj1 = new AlibabaDamaiMzOrderRefundApplyRequest.OrderApplyRefund4cParam();
obj1.setRefundType(0L);
obj1.setMzOrderId("80950450015203");
obj1.setApplyRemark("客户退票");
obj1.setExpressRefundMoneyFen(1000L);
obj1.setTicketCodeNoList("123456,1241415");
obj1.setTicketRefundMoneyFen(20000L);
obj1.setExternalRefundOrderNo("15678456466");
req.setParam(obj1);
AlibabaDamaiMzOrderRefundApplyResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_damai_mz_order_refund_apply_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <mz_refund_order_id>81020070015203</mz_refund_order_id>
            <mz_order_id>80950450015203</mz_order_id>
            <external_refund_order_no>15678456466</external_refund_order_no>
        </data>
        <success>true</success>
    </result>
</alibaba_damai_mz_order_refund_apply_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
40100000 api未知错误 通用系统异常
40100001 api请求失败 通用业务异常
15080001 票信息有误 票信息有误
15080002 非法消单请求 非法消单请求
15080003 固定套票不支持部分退票 固定套票不支持部分退票
15080004 没有可申请的票信息 没有可申请的票信息
15080005 订单类型错误 订单类型错误
15080006 非会员下的单 非会员下的单
15080008 退单票品所处状态不允许申请退票 退单票品所处状态不允许申请退票
15080012 欠款支付订单仅支持整单退票 欠款支付订单仅支持整单退票
15080013 退款金额有误 退款金额有误
15080015 订单已退,不可重复操作 订单已退,不可重复操作
15080016 订单正在申请退票中,请稍后再试 订单正在申请退票中,请稍后再试
15080018 退单正在退款中,请稍后再试 退单正在退款中,请稍后再试
15080019 退单正在审核中,请稍后再试 退单正在审核中,请稍后再试
15080020 退单信息中订单ID不存在 退单信息中订单ID不存在
15080021 退单信息不存在 退单信息不存在

API工具

如何获得此API

FAQ

返回
顶部