SUP-商户订单增加接口
SUP-客户订单状态查询接口
SUP-账户余额查询接口
SUP-商品目录列表
SUP-充值类型列表
SUP-批量获取订单信息接口
SUP-处理订单接口
SUP-修改商品上下架/库存接口
SUP-回调接口说明
功能说明:商家可通过系统API查询订单状态并根据返回状态进行处理
请求频率:10秒/次,实际可能会根据系统压力做出调整,请以系统为准;建议单次查多笔订单减少限制
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
MerchantID | 整数 | Y | 10001 | 商家编号 |
OrderID | 字符 | Y |
201509081125048671001095851 ,20150908112238917100101861 |
订单编号(多个订单以','分隔) |
Sign | 字符 | Y | 45df9db18cc92c64aa9a9096283665f8 | 数字签名,MD5加密(MerchantID+OrderID+key) |
MerchantType | 整数 | Y | 0 | 商家类型:0进货商、1供货商 |
OrderIDType | 字符 | N | 0 | 状态(默认为0):0系统订单编号、1下游订单编号 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
State | 数字 | 0 | 返回状态值(注意,此处仅表示请求是否成功,是否密钥错误等,不是订单状态) |
State_Info | 字符 | 请求成功|成功1个|失败0个 | 状态值|返回备注信息 |
Status | 字符 | 充值成功 | 订单状态中文(这里是订单的真正状态对应的中文 |
StatusType | 字符 | 0 | 订单状态标识(这里是订单的真正状态对应的数字)(充值成功=0,充值失败=1, 处理中=2,可疑订单=3,未处理=4,已分配到供货商=5,全额退款=6) |
SupOrderID | 字符 | 2015101400180989711873289451 | 平台订单编号 |
OrderID | 字符 | 190101-ffu98dfudf8fg9 | 进货商自定义的订单编号 |
DetailMsg | 字符 | 区服不匹配 | 供货商返回的充值信息 |
SupplyUser | 字符 | 易约科技(10001) | 供货商信息,包括名称和编号 |
TradeAmount | 数字 | 10.25 | 订单金额 |
ProductNo | 数字 | 10002 | 所采购商品的编号 |
BuyNumber | 数字 | 10 | 购买数量 |
FaceValue | 数字 | 1 | 商品的面值 |
Cards | 字符 | 卡密信息,具体请看响应示例 | 如果是官方卡密类型则显示卡密信息 |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
<?xml version='1.0'?>
<OrderQuery>
<Result>
<State>0</State>
<State_Info>成功</State_Info>
</Result>
<Orders>
<OrderStatus>
<SupOrderID>2659752331001401</SupOrderID>
<OrderID>a7fygghfdgzhs</OrderID>
<Status>充值成功</Status>
<StatusType>0</StatusType>
<DetailMsg>充值成功123</DetailMsg>
<Cards>
<Card>
<No>2055030521002201</No>
<PassWord>2010079641000701</PassWord>
<ExpireTime>2018-12-22 00:00:00</ExpireTime>
</Card>
</Cards>
</OrderStatus>
</Orders>
</OrderQuery>
|
1
2
3
4
5
6
|
<?xml version='1.0'?>
<Result>
<State>402</State>
<State_Info>订单查询无结果</State_Info>
</Result>
|
异常码 | 错误描述 | 解决方案 |
---|---|---|
2 | 系统异常 | 这种状态下订单绝对不可以失败,可以稍后重试,如果还是发生系统异常建议联系管理员 |
101 | 进货Api未开通 | 请确保已开通进货API权限 |
104 | 进货功能未开通 | 请确保进货功能已经开通 |
402 | 订单查询无结果 | 订单查询无结果 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
0 | 成功 | 无需解决 |
1 | 失败 | 无需解决 |
3 | 参数有误 | 请检查参数的值 |
4 | 商家编号不存在 | 请确保商家编号是否正确填写,如果正确填写仍然出现此问题则联系管理员获取商家编号 |
5 | 密钥错误 | 如果加密不正确则查看加密方式/参数是否正确!如果确保加密正确,则联系管理员获取正确的密钥 |
6 | 商家编号应为数字 | 商家编号填写错误,应该填写数字格式 |
7 | 请求过于频繁 | 请适当增加2次请求的间隔 |
8 | IP不在许可范围内 | 请联系管理员解决问题 |
13 | 商家已禁用 | 请联系管理员解决问题 |
401 | 商家状态有误 | 请联系管理员查询该商家状态是否正确 |
500 | 暂停服务 | 稍后再试,如果返回结果依然是暂停服务,则联系管理员 |
特别注意:
1. 如果有多个卡则有多个
2.订单状态值(字段”Status”)的具体中文可能会跟系统中有所差异,请以系统为准
Copyright©2015 北京易约科技有限公司 eyue123.com 保留一切权利。