用户交易定制

更新时间:2015/12/17 访问次数:3256

介绍

  • 交易焦点属于Beta阶段,有任何问题欢迎联系我们
  • 这里提供的功能,帮助客服平台搭建的更加完整,你可以选择性集成
  • 如果您对客服平台接入不清楚,可以参考客服平台快速集成
  • 如果您对交易定制不清楚,可以参考用户足迹定制
  • 当开发者采用官方提供的足迹插件时,如果需要在插件中展现交易焦点详细信息,需要提供如下服务。

在TOP开发后台,开发者可以设置一个http服务url,该http服务可以自主选择提供的服务种类,具体见http服务接口协议
此处包含gettradefocus,gettradefocus请求的参数和返回格式约定如下:

request格式:

{
    "userid":"u1", //userid
    "tradesId":[id1,id2,...] //订单id集合
}

response格式:

{
   "code" :200,
   "desc": "", //返回描述,例如错误描述
   "tradeDetail": [
   {
     "userid":"u1", //买家id
     "tradeid": "id", //交易id
     "tradeurl": "url", //订单详细url
     "items":[
       {
         "itemid": "nn", //宝贝id
         "itemname": "nn", //宝贝名称
         "itempic":"www.a.com/a/a.jpg", //宝贝图片
         "itemprice": "123.23", //以元为单位的浮点数,宝贝单价
         "itemurl":"", //宝贝具体页面url
         "itemnum":2, //宝贝购买数量
       },
       {
         ...
       }
      ],
     "postfee","1.2" //以元为单位的浮点数,订单邮费
     "price": "123.23", //以元为单位的浮点数,实付价格
     "status:"",//订单状态,例如TRADE_NO_CREATE_PAY,具体见下表
     "refundstatus":"",//退款订单状态,具体见下表
     "createtime":"", //交易创建时间,yyyy-MM-dd HH:mm:ss
     "paytime":"", //交易付款时间,yyyy-MM-dd HH:mm:ss
     "endtime":"", //交易结束时间,yyyy-MM-dd HH:mm:ss
     "sid":"123", //物流运单号
     "extra":{"k1":"v1","k2":"v2",...} //扩展描述
   },
   ...
   ]
}


交易信息字段

集成方可以根据实际业务场景选择性的实现下面的字段集合

字段名 含义 格式
itemid 宝贝id 字符串
itemname 宝贝名称 字符串
itempic 宝贝缩图 字符串
itemprice 宝贝价格 以元为单位的浮点数
itemurl 宝贝对应的url 字符串
tradeid 交易id 字符串
tradeurl 交易详细url 字符串
itemnum 购买的宝贝数量 整型
postfee 邮费价格 以元为单位的浮点数
price 实付价格 以元为单位的浮点数
status 订单状态 字符串
refundstatus 订单退款状态,如果不在退款中填空 字符串
createtime 交易付款时间 字符串
endtime 交易结束时间 字符串
sid 物流运单号 字符串
extra 订单扩展字段 json串



status具体定义如下:

交易状态字段 含义 文案提示
TRADE_NO_CREATE_PAY 没有创建交易 没有创建交易
WAIT_BUYER_PAY 等待买家付款 等待买家付款
WAIT_SELLER_SEND_GOODS 等待卖家发货,即:买家已付款 等待卖家发货
WAIT_BUYER_CONFIRM_GOODS 等待买家确认收货,即:卖家已发货 卖家已发货
TRADE_BUYER_SIGNED 买家已签收,货到付款专用 买家已签收
TRADE_FINISHED 交易成功 交易成功
TRADE_CLOSED 付款以后用户退款成功,交易自动关闭 交易关闭
TRADE_CLOSED_BEFOREPAY 付款以前,卖家或买家主动关闭交易 交易关闭

refundstatus具体定义如下:

退款状态字段 含义 文案提示
WAIT_SELLER_AGREE 买家已经申请退款,等待卖家同意 买家已经申请退款,等待卖家同意
WAIT_BUYER_RETURN_GOODS 卖家已经同意退款,等待买家退货 卖家已经同意退款,等待买家退货
WAIT_SELLER_CONFIRM_GOODS 买家已经退货,等待卖家确认收货 买家已经退货,等待卖家确认收货
SELLER_REFUSE_BUYER 卖家拒绝退款 卖家拒绝退款
CLOSED 退款关闭 退款关闭
SUCCESS 退款成功 退款成功

FAQ

关于此文档暂时还没有FAQ
返回
顶部