商户订单增加接口
客户订单状态查询接口
API单笔虚拟订单行查询服务
获取店铺评分
商户订单直连接口
批量获取历史订单(三个月前的历史订单)
批量获取订单(三个月内的订单)
批量获取订单号
单笔订单查询
订单备注查询
延迟交易收货时间
获取物流公司代码(查询单个)
获取物流公司代码(查询全部)
根据订单修改时间批量查询订单信息
未付款订单查询
订单发货(商家自配送)
顾客投诉记录处理
顾客投诉处理记录查询
苏宁顾客投诉记录单笔查询
顾客投诉记录批量查询
订单发货(海外购)
订单发货(包裹单号发货)
海外购订单申报(商家、苏宁保税仓发货)
海外购订单申报(海外直邮)
订单评价批量查询(三个月前)
订单评价批量查询(三个月内)
订单评价单笔查询查询
商家回复订单评价
未付款订单修改运费接口
查询已回传苏宁的电子发票
电子发票回流苏宁接口
供SUP系统与商家系统直接对接,商家将订单通过系统API将订单直接下传给SUP系统。
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
MerchantID | 整数 | Y | 10001 | 商家编号 |
Catagory | 整数 | Y | 94 | 目录(详细查看文件最后的目录列表) |
BuyNumber | 整数 | Y | 1 | 购买数量(每个充值号购买数量) |
ChargeAccount | 字符 | Y | 123456789 | 充值号(多个用','分隔) |
Sign | 字符 | Y | 7fgydfgfdgfug | 数字签名,MD5加密(MerchantID+Catagory+BuyNumber+ChargeAccount+key) |
OrderID | 字符 | N | fh7fyhfgh783hgugfgjfdg | 订单编号 |
ProductNo | 整数 | N | 0 | 商品编号(关联的商品编号,如果为‘0’系统自动分配) |
FaceValue | 整数 | N | 0 | 订单面值(默认为0)(购买官方卡密商品必填) |
GameName | 字符 | N | DNF点券 | 充值名称 |
Area | 字符 | N | 北京1区 | 充值区域 |
Srv | 字符 | N | 没有则留空或者不传 | 充值服务器 |
Otherinfo | 字符 | N | 这是一个DNF订单 | 其他信息 |
AtlatestSaveTime | 字符 | N | 2015-09-08 10:22:59 | 最晚处理时间(默认比当前时间推迟30分钟)(时间格式:yyyy-MM-dd HH:mm:ss) |
ReturnUrl | 字符 | N | http://www.baidu.com/Callback | 回调地址(详细说明见下方) |
RechargeType | 整数 | N | 1 | 充值类型(具体数据参考文档最后) |
RechargeTypeName | 字符 | N | 直冲 | 充值类型名称,注意:如果RechargeType参数也赋值的情况下此参数无效 |
RechargeTypeName | 字符 | N | 直冲 | (V1.5新增)充值类型名称,注意:如果RechargeType参数也赋值的情况下此参数无效 |
BuyerIp | 字符 | N | 111.111.111.111 | 买家IP地址 |
OrderType | 整数 | N | 1 | 订单类型(1:官方卡密 0:接口供货)当购买官方卡密时必须传递参数为1 |
RoleName | 字符 | N | 冰封の绝恋 | (v1.6新增)充值角色名称 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
State | 数字 | 0 | 返回状态值(详细请状态值列表) |
State_Info | 字符 | 请求成功|成功1个|失败0个 | 状态值|返回备注信息 |
ChargeAccount | 字符 | 123456789 | 充值帐号 |
SupOrderID | 字符 | 2015101400180989711873289451 | 平台订单号 |
OrderID | 字符 | 如果提交了自定义的订单号将显示在这里,否则为空 | 下游订单号 |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
<?xml version='1.0'?>
<Result>
<State>0</State>
<State_Info>请求成功|成功1个|失败0个</State_Info>
<Orders>
<Order>
<ChargeAccount>123456789</ChargeAccount>
<SupOrderID>2659752331001401</SupOrderID>
<TradeAmount>0.8800</TradeAmount>
<Cards>
<Card>
<No>2055030521002201</No>
<PassWord>2010079641000701</PassWord>
<ExpireTime>2018-12-22 00:00:00</ExpireTime>
</Card>
</Cards>
</Order>
</Orders>
</Result>
|
1
2
3
4
5
6
|
<?xml version='1.0'?>
<Result>
<State>117</State>
<State_Info>订单编号重复</State_Info>
</Result>
|
异常码 | 错误描述 | 解决方案 |
---|---|---|
2 | 系统异常 | 查询订单状态,若无此订单,则为失败,如果有订单状态返回,则返回状态为该订单状态 |
101 | 进货Api未开通 | 请确保已开通进货API权限 |
102 | 商品目录不正确 | 请确保填写的商品目录格式为整数且存在 |
103 | 最晚处理时间格式有误 | 请确保最晚处理时间格式正确 |
104 | 进货功能未开通 | 请确保进货功能已经开通 |
105 | 账号余额不足 | 请向平台汇款,以确保余额充足 |
106 | 无关联供货商品 | 请确保商品编号填写正确 |
107 | 供货价格太高 | 请确保订单金额足以购买该商品 |
108 | 商品目录应为数字 | 请确保商品目录为数字 |
109 | 购买数量应为数字 | 请确保购买数量为数字 |
110 | 商品编号应为数字 | 请确保商品编号为数字 |
111 | 充值账号最多为1000个 | 请确保充值账号数量小于等于1000个 |
112 | 最晚处理时间应大于当前时间 | 请确保最晚处理时间大于当前时间 |
113 | 最晚处理时间应在30分钟以后 | 请确保最晚处理时间在30分钟以后 |
114 | 禁售时间段内 | 请勿在禁售时间段内购买该商品 |
115 | 订单面值有误 | 请确保订单面值正确 |
116 | 订单编号最长为32位 | 订单编号过长,可以选择不传此值 |
117 | 订单编号重复 | 等同于成功,可查询订单状态后进行处理 |
201 | 商品编号有误 | 请确保商品编号正确 |
202 | 订单数量不在范围内 | 可根据商品信息重新修改订单数量 |
401 | 商家状态有误 | 联系管理员查询该商家目前是否可以正常进货 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
0 | 成功 | 无需解决 |
1 | 失败 | 无需解决 |
3 | 参数有误 | 请检查参数的值 |
4 | 商家编号不存在 | 请确保商家编号是否正确填写,如果正确填写仍然出现此问题则联系管理员获取商家编号 |
5 | 密钥错误 | 如果加密不正确则查看加密方式/参数是否正确!如果确保加密正确,则联系管理员获取正确的密钥 |
6 | 商家编号应为数字 | 商家编号填写错误,应该填写数字格式 |
有关回调地址说明:
如果向系统提交了回调地址则会在订单充值成功/失败的时候向指定的地址采用Get方式发送充值结果
响应参数:
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
SupOrderID | 数字 | 2015101400180989711873289451 | 系统内部订单号 |
OrderID | 字符 | s3rfdfkdfjdf043t4 | 下游自定义订单号 |
ChargeAccount | 字符 | 123456789 | 充值帐号 |
Status | 字符 | 可疑订单/充值成功/充值失败 ,utf-8编码返回 | 充值状态(所有的订单状态请参见sup后台) |
DetailMsg | 字符 | 充值失败 | 充值失败时会有具体失败原因,utf-8编码返回 |
Sign | 字符 | ecac7900f965a74f011facdfb36e244f | 数字签名Md5(SupOrderID+OrderID+ Status+ key) |
StatusNo | 数字 | 0 |
充值状态的编号 数字,跟上面的Status中文一一对应0:充值成功 1:充值失败 2:处理中 3:可疑订单 |
Sign2 | 字符 | 0 | 另外一组数字签名Md5(SupOrderID+OrderID+ StatusNo + key) |
Cards | 字符 | 0 |
卡密类订单的卡密信息
类似这样的多组数据可以自行解析,[{'No':'2055029031001601','PassWord':'2010079641000701', 'ExpireTime':'2018-12-22 00:00:00'}] |
特别注意:
1.计算此次的sign值的时候因为涉及到中文,所以请用utf-8编码
2.合作方收到请求后必须给我们返回”ok”,大小写不限,否则系统将一直请求持续30分钟
3.订单在可疑/成功/失败的时候都会回调,也就是说有可能先收到可疑的状态通知,然后又收到成功/失败,所以要做好后续处理,不要收到可疑就直接放弃此订单的通知接收
4.如果部分开发语言对中文的参与验签的时候跟我们系统返回总是不对,那请验签Sign2,这个不包含中文. 只要Sign和Sign2 里面有任意一个签名是正确的 就说明请求合法有效
Copyright©2015 北京易约科技有限公司 eyue123.com 保留一切权利。
京ICP备:11047933号-4 公安网备案号:11010802021777 网络文化经营许可证:京网文(2017)5467-652号