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

taobao.refund.smart.negotiation.submit (协商托管方案发起)

协商托管方案发起

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
negotiation_factors NegotiationFactors 必须 协商因子。若选中了对应协商方案,则此参数必传
  • └ return_address
  • Number
  • 可选
  • 112233
  • 售后退款地址id
  • └ negotiation_script
  • String
  • 可选
  • 非常抱歉给您带来不便。
  • 协商话术
  • └ refund_amount
  • Number
  • 可选
  • 10000
  • 退款金额(单位:分)
negotiation_type String 必须 partial_refund_retention 协商类型,目前支持:partial_refund_retention(协商部分退款挽回),return_and_refund(协商退货退款),cancel_refund(协商撤销退款)。
refund_id Number 必须 112233 退款编号

响应参数

名称 类型 示例值 描述
failure_reason String 退款单号不存在或已失效 失败原因
status Boolean false 发起协商成功与否

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
RefundSmartNegotiationSubmitRequest req = new RefundSmartNegotiationSubmitRequest();
RefundSmartNegotiationSubmitRequest.NegotiationFactors obj1 = new RefundSmartNegotiationSubmitRequest.NegotiationFactors();
obj1.setReturnAddress(112233L);
obj1.setNegotiationScript("非常抱歉给您带来不便。");
obj1.setRefundAmount(10000L);
req.setNegotiationFactors(obj1);
req.setNegotiationType("partial_refund_retention");
req.setRefundId(112233L);
RefundSmartNegotiationSubmitResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<refund_smart_negotiation_submit_response>
    <failure_reason>退款单号不存在或已失效</failure_reason>
    <status>false</status>
</refund_smart_negotiation_submit_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

返回
顶部