销售系统商户订单增加接口
销售系统订单状态查询接口
销售系统账户余额查询接口
销售系统查询所有商品列表接口
销售系统查询指定商品详情接口
销售系统查询全部目录接口
回调接口说明
功能说明:商家可通过系统API查询订单状态并根据返回状态进行进一步处理。其中xxx为您在eyuesale的二级域名,或者您自行申请的域名(具体域名请咨询您的业务对接人)。
请求频率：10秒/次，实际可能会根据系统压力做出调整,请以系统为准
强烈建议：为了避免接口限制,请尽量使用回调机制或者单次查询多个订单;尽量避免高并发一次查一单的情况
请求方式：http协议,Get/Post
字符编码：UTF-8
提交数据格式：QueryString (eg:a=123&b=456)
返回数据格式：XML
| 名称 | 类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
| MerchantID | 整数 | Y | 10001 | 商家编号 |
| OrderID | 字符 | Y | 201509081125048671001095851 ,20150908112238917100101861 |
订单编号(多个订单以','分隔) |
| Sign | 字符 | Y | 45df9db18cc92c64aa9a9096283665f8 | 数字签名，把下列参数值按照顺序组成新字符串后计算MD5值(32位大小写均可),MD5(MerchantID+OrderID+商户密钥) |
| MerchantType | 整数 | Y | 0 | 商家类型:0进货商、1供货商 |
| OrderIDType | 字符 | N | 0 | 订单编号类型（默认为0）：0易约销售系统生成的订单编号、1合作商自定义的下游订单编号 |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| State | 数字 | 0 | 返回状态值(注意,此处仅表示请求是否成功,是否密钥错误等,不是订单状态) |
| State_Info | 字符 | 成功 | 状态值｜返回备注信息 |
| Status | 字符 | 充值成功 | 订单状态中文(这里是订单的真正状态对应的中文 |
| StatusType | 字符 | 0 | 订单状态标识(这里是订单的充值状态对应的数字)(充值成功=0,充值失败=1,处理中=2,可疑订单=3,部分退款=5,全额退款=6),其中1和6都可当失败处理,其他不能当失败 |
| SupOrderID | 字符 | 2015101400180989711873289451 | 平台订单编号 |
| OrderID | 字符 | ffu98dfudf8fg9 | 订单编号 |
| DetailMsg | 字符 | 区服不匹配 | 供货商返回的充值信息 |
| Cards | 字符 | 卡密信息,具体请看响应示例 | 如果是官方卡密类型则显示卡密信息 |
| No | 字符 | 8451515132123 | 官方卡密卡号 |
| PassWord | 字符 | 卡密信息,具体请看响应示例 | 官方卡密密码 |
| ExpireTime | 字符 | 2018-10-16 14:30:00 | 官方卡密过期时间,格式为yyyy-MM-dd HH:mm:ss |
| RechargeAccount | 字符 | 123456 | 订单充值帐号 |
|
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>
<RechargeAccount>123456</RechargeAccount>
</OrderStatus>
</Orders>
</OrderQuery>
|
|
1
2
3
4
5
6
|
<?xml version='1.0'?>
<Result>
<State>402</State>
<State_Info>订单查询无结果</State_Info>
</Result>
|
| 异常码 | 订单失败 | 错误描述 | 解决方案 |
|---|---|---|---|
| 2 | 否 | 系统异常 | 这种状态下订单绝对不可以失败,可以稍后重试,如果查询结果还是系统异常建议联系管理员 |
| 10 | 否 | 重复请求 | 请适当增加2次请求的间隔 |
| 11 | 否 | 系统繁忙请稍候再试 | 这种状态下订单绝对不可以失败,可以稍后重试,如果查询结果还是系统繁忙请稍候再试建议联系管理员 |
| 402 | 否 | 订单查询无结果 | 建议人工核实 |
| 异常码 | 订单失败 | 错误描述 | 解决方案 |
|---|---|---|---|
| 0 | 否 | 成功 | 此时分析<Status>或者<StatusType>标签确认订单充值状态 |
| 1 | 否 | 失败 | 无需解决 |
| 3 | 否 | 参数有误 | 请检查参数的值 |
| 4 | 否 | 商家编号不存在 | 请确保商家编号是否正确填写,如果正确填写仍然出现此问题则联系管理员获取商家编号 |
| 5 | 否 | 密钥错误 | 如果加密不正确则查看加密方式/参数是否正确!如果确保加密正确,则联系管理员获取正确的密钥 |
| 6 | 否 | 商家编号应为数字 | 商家编号填写错误,应该填写数字格式 |
| 7 | 否 | 请求过于频繁 | 请适当增加2次请求的间隔 |
| 8 | 否 | IP不在许可范围内 | 请联系管理员通过"系统管理"--"接口IP配置"为您配置接口IP白名单 |
| 9 | 否 | 无API权限 | 请联系管理员通过"系统管理"--"客户档案管理"--"权限设置"为您勾选"API接口增加订单" |
| 15 | 否 | 账号未验证 | 请联系管理员解决问题 |
| 16 | 否 | 商家已禁用 | 请联系管理员解决问题 |
| 128 | 否 | 系统暂时关闭请联系管理员 | 系统暂时关闭请联系管理员 |
| 144 | 否 | 当前公司已禁用 | 请联系管理员解决问题 |
| 401 | 否 | 商家状态有误 | 请联系管理员查询该商家状态是否正确 |
特别注意:
1. 如果有多个卡则有多个
2.订单状态值(字段”Status”)的具体中文可能会跟系统中有所差异,请以系统为准
Copyright©2015 北京易约科技有限公司 eyue123.com 保留一切权利。