文档中心 > API类目 > 淘宝退款API

taobao.refund.smart.negotiation.status.get (协商托管方案查询)

协商托管方案查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
refund_id Number 必须 112233 售后单号

响应参数

名称 类型 示例值 描述
negotiation_status String success 退款协商状态的编码,目前支持:process(协商中),success(协商成功),failed(协商失败)
negotiation_start_time Date 2024-02-20 14:15:30 yyyy-mm-dd hh:mm:ss,协商发起时间(以最近一次协商为准)
has_negotiation Boolean true 售后单是否发起过协商
negotiation_type String partial_refund_retention 协商方案的编码,目前支持:partial_refund_retention(协商部分退款挽回),return_and_refund(协商退货退款),cancel_refund(协商撤销退款)
return_address Number 112233 售后退款地址id
refund_amount Number 10000 退款金额(单位:分)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
RefundSmartNegotiationStatusGetRequest req = new RefundSmartNegotiationStatusGetRequest();
req.setRefundId(112233L);
RefundSmartNegotiationStatusGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<refund_smart_negotiation_status_get_response>
    <negotiation_status>success</negotiation_status>
    <negotiation_start_time>2024-02-20 14:15:30</negotiation_start_time>
    <has_negotiation>true</has_negotiation>
    <negotiation_type>partial_refund_retention</negotiation_type>
    <return_address>112233</return_address>
    <refund_amount>10000</refund_amount>
</refund_smart_negotiation_status_get_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

返回
顶部