易约开放服务-API列表

返回API列表

SaveOrderAPI
SUP-商户订单增加接口
QueryOrderAPI
SUP-客户订单状态查询接口
GetAccountAPI
SUP-账户余额查询接口
ProductCatalogAPI
SUP-商品目录列表
RechargeTypeListAPI
SUP-充值类型列表
AutomaticCompatibility
程序自动兼容SUP和销售系统两个接口
GetOrdersAPI
SUP-批量获取订单信息接口
HandleOrderAPI
SUP-处理订单接口
UpdateProductStateAPI
SUP-修改商品上下架/库存接口
UpdateProductStateAPI
SUP-回调接口说明

http://api.eyuesup.com/api/SaveOrder 虚拟订单增加API

功能说明:供SUP系统进货商将订单推送到SUP系统进行充值。(目前已关闭对外服务)

请求频率：无限制，实际可能会根据系统压力做出调整,请以系统为准

请求参数
响应参数
请求示例
响应示例
异常示例
业务异常码
公共异常码
FAQ(含回调说明)

请求参数

名称	类型	是否必须	示例值	描述
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	字符	如果提交了自定义的订单号将显示在这里,否则为空	下游订单号

请求示例

响应示例

XML示例

复制全部代码

                                            
                                                                    <?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>

异常示例

XML示例

复制全部代码

                                            
                                                                    <?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	订单数量不在范围内	可根据商品信息重新修改订单数量

公共异常码

异常码	错误描述	解决方案
0	成功	无需解决
1	失败	无需解决
3	参数有误	请检查参数的值
4	商家编号不存在	请确保商家编号是否正确填写,如果正确填写仍然出现此问题则联系管理员获取商家编号
5	密钥错误	如果加密不正确则查看加密方式/参数是否正确!如果确保加密正确,则联系管理员获取正确的密钥
6	商家编号应为数字	商家编号填写错误,应该填写数字格式
7	请求过于频繁	请适当增加2次请求的间隔
8	IP不在许可范围内	请联系管理员解决问题
13	商家已禁用	请联系管理员解决问题
401	商家状态有误	请联系管理员查询该商家状态是否正确
500	暂停服务	稍后再试,如果返回结果依然是暂停服务,则联系管理员

FAQ(回调说明在此查看)

有关回调地址说明:

如果向系统提交了回调地址则会在订单充值成功/失败的时候向指定的地址采用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 里面有任意一个签名是正确的就说明请求合法有效