注意:以下文档只适用于TOP接口,请谨慎使用!

alibaba.idle.isv.order.dealrefund (闲鱼电商SAAS服务商退款处理接口)

闲鱼无忧购业务入仓模式下,用户发起退款后,服务商使用此接口处理退款

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_appraise_isv_refund_request AppraiseIsvRefundRequest 可选 退款参数
  • └ biz_order_id
  • Number
  • 必须
  • 111222333
  • 订单号
  • └ leave_message
  • String
  • 可选
  • 这里写退款操作的说明
  • 退款操作说明
  • └ operation
  • String
  • 必须
  • AGREE_REFUND
  • 退款操作/** * 同意退款并执行打款->退款成功,仅退款情况下,直接调用;退货退款情况下,先调用同意退货接口,收到货再调用这个接口 */ AGREE_REFUND, /** * 拒绝退款 -> 退款关闭 */ REFUSE_REFUND, /** * 同意退货并提供退货地址 -> 等待买家退货 */ AGREE_RETURN
  • return_goods_address
  • ShippingAddressInfo
  • 可选
  • 退货地址
  • └ address_detail
  • String
  • 可选
  • xx省xx市xx区xx路xx大厦xx室
  • 这里必须写全详细地址
  • └ area
  • String
  • 可选
  • xx区
  • └ city
  • String
  • 可选
  • xx市
  • └ consignee_name
  • String
  • 可选
  • 张三
  • 收件人姓名
  • └ mobile_phone
  • String
  • 可选
  • 13911911010
  • 手机号码
  • └ post_code
  • String
  • 可选
  • 000000
  • 邮编
  • └ province
  • String
  • 可选
  • 浙江省
  • └ tel_no
  • String
  • 可选
  • 010-123456
  • 固话
  • └ town
  • String
  • 可选
  • xx街道/xx镇
  • 四级地址 镇/街道
  • └ division_code
  • String
  • 可选
  • 110102
  • 区域id

响应参数

名称 类型 示例值 描述
module RefundDto null 退款信息
  • └ apply_refund_fee
  • Number
  • 100
  • 申请退款金额
  • └ biz_order_id
  • Number
  • 111222333
  • 订单Id
  • └ dispute_id
  • Number
  • 333444555
  • 退款单ID
  • └ real_refund_fee
  • Number
  • 100
  • 实际退款金额
  • └ refund_status
  • String
  • 2
  • 退款状态 与逆向DisputeStatusEnum 一致,1-9
  • └ refund_time
  • Date
  • 2021-03-05 11:00:00
  • 退款时间
  • └ refund_type
  • String
  • REFUND_ONLY_NO_SHIP
  • 申请退款类型: REFUND_ONLY_NO_SHIP(未发货仅退款),REFUND_ONLY_NO_RECIVE(已发货未收到货仅退款),REFUND_ONLY_WHIT_GOODS(收到货仅退款(退货退款))
  • └ return_goods_status
  • String
  • UNSHIPPED
  • 退货状态 GoodsStatusEnum 一致
  • └ timeout
  • Number
  • 3600
  • 到达下一个节点的超时时间点

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleIsvOrderDealrefundRequest req = new AlibabaIdleIsvOrderDealrefundRequest();
AlibabaIdleIsvOrderDealrefundRequest.AppraiseIsvRefundRequest obj1 = new AlibabaIdleIsvOrderDealrefundRequest.AppraiseIsvRefundRequest();
obj1.setBizOrderId(111222333L);
obj1.setLeaveMessage("这里写退款操作的说明");
obj1.setOperation("AGREE_REFUND");
AlibabaIdleIsvOrderDealrefundRequest.ShippingAddressInfo obj2 = new AlibabaIdleIsvOrderDealrefundRequest.ShippingAddressInfo();
obj2.setAddressDetail("xx省xx市xx区xx路xx大厦xx室");
obj2.setArea("xx区");
obj2.setCity("xx市");
obj2.setConsigneeName("张三");
obj2.setMobilePhone("13911911010");
obj2.setPostCode("000000");
obj2.setProvince("浙江省");
obj2.setTelNo("010-123456");
obj2.setTown("xx街道/xx镇");
obj2.setDivisionCode("110102");
obj1.setReturnGoodsAddress(obj2);
req.setParamAppraiseIsvRefundRequest(obj1);
AlibabaIdleIsvOrderDealrefundResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_idle_isv_order_dealrefund_response>
    <module>
        <apply_refund_fee>100</apply_refund_fee>
        <biz_order_id>111222333</biz_order_id>
        <dispute_id>333444555</dispute_id>
        <real_refund_fee>100</real_refund_fee>
        <refund_status>2</refund_status>
        <refund_time>2021-03-05 11:00:00</refund_time>
        <refund_type>REFUND_ONLY_NO_SHIP</refund_type>
        <return_goods_status>UNSHIPPED</return_goods_status>
        <timeout>3600</timeout>
    </module>
</alibaba_idle_isv_order_dealrefund_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部