文档中心 > API类目 > 淘宝交易API

taobao.trade.close (卖家关闭一笔交易)

关闭一笔订单,可以是主订单或子订单。当订单从创建到关闭时间小于10s的时候,会报“CLOSE_TRADE_TOO_FAST”错误。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tid Number 必须 123456789 主订单或子订单编号。
close_reason String 必须 买家不想买了 交易关闭原因。可以选择的理由有:1.未及时付款2、买家不想买了3、买家信息填写错误,重新拍4、恶意买家/同行捣乱5、缺货6、买家拍错了7、同城见面交易

响应参数

名称 类型 示例值 描述
trade Trade 关闭交易时返回的Trade信息,可用字段有tid和modified
  • └ tid
  • Number
  • 2231958349
  • 交易编号 (父订单的交易编号)
  • └ modified
  • Date
  • 2000-01-01 00:00:00
  • 交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ss

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TradeCloseRequest req = new TradeCloseRequest();
req.setTid(123456789L);
req.setCloseReason("买家不想买了");
TradeCloseResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<trade_close_response>
    <trade>
        <tid>2231958349</tid>
        <modified>2000-01-01 00:00:00</modified>
    </trade>
</trade_close_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>

错误码解释

错误码 错误描述 解决方案
isv.invalid-parameter:tid 参数:tid无效,格式不对、非法值、越界等
isv.invalid-parameter:close_trade_too_fast 关闭订单太快,订单创建后10s内不允许关闭 控制程序,限制10能不能操作关闭订单功能
isv.trade-service-error:TRADE_STATUS_NOT_AVAILD 订单状态不对,不能关闭订单 仅创建未付款订单,可调该接口关闭
isv.invalid-parameter:closereason_wrong 关闭原因错误 关闭原因错误,请输入系统提供的指定原因
isv.close-order-reached-upper-limit 达到单个商家关闭订单的频率控制。 单个商家关闭订单有分钟级频率控制,出现这种报错不要重试,等下一分钟进行操作。
isv.close-order-too-fast-error
isv.trade-service-error
isv.trade-not-exist
isv.invalid-parameter:close_group_order_too_fast
isv.invalid-permission
isv.trade-service-error:SYSTEM_ERROR

API工具

如何获得此API

FAQ

返回
顶部