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