在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 | 退款成功 | 退款成功 |