欧飞HTTP接口文档(V6.10)

欧飞SP合作接口文档

OFCARD系统http接口协议(V6.10)

????? 本版本最后修订日期： 2015年4月10日 版本号 4.0 日期 2008-12-15 说明 增加版本号字段，SP接入密码修改为账户密码的MD5值 增加游戏区服接口，开通电信手机充值 修正商品对应分类错误 增加买家IP字段 订单查询地址变动 接口域名变动（新接口用户启用） 增加移动慢充接口 增加根据手机号和面值查询商品信息 增加身份证核查接口 增加固话查询和充值接口 修改版本号，修改手机直充可选面值 修改接口使用顺序、增加文档说明 出现错误码时只返回错误码和错误描述 增加支付宝直充接口 新增中石化加油卡接口 新增苹果APP充值接口 新增私有库存接口 接口刷新: 获取游戏的版本信息 苹果app充值，充值下单 修改水电煤欠费查询接口 增加中石化加油卡卡号信息查询接口 增加流量充值接口 增加换卡接口、撤销接口、银行转账接口及查询接口 修改加油卡直充及查询接口 增加流量查询接口 作者 5.0 5.1 5.2 5.3 5.4 5.5 6.0 6.1 6.2 6.3 6.4 6.5 6.6 2009-5-7 2009-01-08 2010-7-13 2011-01-13 2011-08-23 2011-09-26 2011-09-28 2012-04-18 2012-05-26 2012-09-26 2013-03-26 2013-12-21 2014-4-23 2014-4-28 2014-07-12 2014-8-6 6.7 6.8 6.9 6.9.1 6.10 2014-9-23 2014-10-14 2014-11-21 2015-03-31 2015-4-10 说明

本文档供SP和本项目的后续开发维护人员使用，为了业务系统的安全，请严格不泄露本协议接口。

在这个接口协议中，欧飞OFCARD作为内容供应商，我们称之为CP，调用我们接口的机密

第 1 页 共 47 页

欧飞SP合作接口文档

商户作为一个业务点，我们称之为SP。 通过接口SP能够根据需要从CP实时获得需要的商品信息，可以提取卡密或者对帐号进行实时充值。

本接口的业务逻辑基于欧飞API供货大接口（http://api.ofpay.com/api/），SP使用该接口之前必须注册成经销商或者直销商，提供SP服务器IP地址，通知欧飞工作人员开通Http接口功能，欧飞为你分配相应功能模块和MD5 key值，你的登陆密码不能设置的太简单，请不要向任何人，包括欧飞工作人员泄露你的直销系统登陆密码。

欧飞针对本协议接口没有架设测试环境，拿到该接口的SP，请直接进入生产环境（地址和端口详见各个功能模块）进行测试，SP注册后可以自行购买一定数量的信用点（信用点可以理解成预存款，没有信用点的情况下，SP无法进行提卡和充值），建议用编码为360101的测试卡进行提卡测试，用Q币进行充值测试。

SP可以登陆欧飞直销系统查看交易记录进行对帐，也可以使用对帐接口进行自动对帐。 关于接口的另外几点说明：

- 该接口使用HTTP协议，请求数据传输格式如下：

【接口URL】?【参数名称1】=【参数值1】&【参数名称2】=【参数值2】?? 2、所有接口的应答在HTTP包体中将以XML形式返回； 3、所有的接口请求通过后台调用； 4、各参数的参数名全部为小写；

5、欧飞服务器是放在电信机房，如果合作伙伴需要更快的接入速度，最好放在电信机房 6．其中文档提到的“+”是连接字符的意思。

7.接口调用出现超时或其它错误时，需联系我们客服，或者主动到平台进行核实。 8.注册账号之后,请联系商务绑定SP服务器IP地址,否则在调用接口时会产生IP验证错误。

协议的交互逻辑

SP 发送http请求 返回xml结果 CP

机密 第 2 页 共 47 页

欧飞SP合作接口文档

1用户信息查询接口（queryuserinfo.do）

此接口可以查询到SP用户的信用点余额，可以提醒SP进行补充信用点： 请求参数： userid userpws version 响应的XML标签说明 err_msg retcode ret_leftcredit 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 账户剩余金额 说明 SP编码如（A00001），可由SP自动注册生成,在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 固定值为：6.0(不参与MD5验证) 调用的链接如下：

http://api2.ofpay.com/queryuserinfo.do?userid=Axxxxx&userpws=xxxxxxx&version=6.0

返回的XML：

1

352328.97 AXXXXX

2查询所有商品大类（querybigcard.do）

此接口用于查询所有商品的大类信息

调用的链接如下：

http://api2.ofpay.com/querybigcard.do 返回的内容：

1 - -

23

// 大类编码

游戏辅助卡 //大类名称

机密 第 3 页 共 47 页

欧飞SP合作接口文档

3商品小类信息同步接口（querylist.do）

此接口依据用户提供的商品大类编码返回此中的小类列表和小类信息（可以同步到本地，定时维护，不用每次都去查询）： 请求参数： 说明 userid SP编码如（A00001）在登陆系统时得到以A开头的编号 userpws SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 需查询商品的编码（支持2位，4位编码，2位表示该大类下的所有商品，4位是具体的小类商品） (21 游戏卡密、22 游戏直充、14 移动话费、15 联通话费、19 电信话费) 固定值为：6.0 (不参与MD5验证) 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 用户所需查询的商品 cardid version 响应的XML标签说明 err_msg retcode ret_cardinfos 调用的链接如下：

http://api2.ofpay.com/querylist.do?userid=Axxxxx&userpws=xxxxxxx&cardid=2303&version=6.0 如：userid=A000002;userpws=111111;cardid=36;version=6.0

返回的内容：

-

1 - -

2303

// 小类商品编码 //小类商品名称

23 //此子类商品所属大类编码 劲舞挂机宝贝

1ò?ú±|±′?μáDê?

ò????ìé?μ?í?ó??¨?ú1¤??￡??ü2éó? ?±?èí?t×÷?aò???

机密 第 4 页 共 47 页

欧飞SP合作接口文档

?ìé?μ?1¤??￡????eμ??¨?úμ?×÷ó??￡

//商品介绍

//资费说明

//开通城市

35?a/?? 全国

3??μμ??·￡ohttp://www.guajibaobei.com/chongzhi.htm
1ù·?í???￡ohttp://www.guajibaobei.com site>

//充值网址

//产品产地

//使用方法

http://www.guajibaobei.com/chongzhi.htm中国

è?1??ú?ú1o?ò?

DóD?êìa??oí?ò??áa?μ￡o?í·tQQ￡o393462μ??°￡o025-52255777email￡oservice@ofcard.com+è?ó?μ?1ù·?í￡?1·t??￡?±??μí32?3Dμ￡è?o??eè??￡//客服服务中心

4具体商品信息同步接口（querycardinfo.do）

此接口依据用户提供的商品编码返回此商品的具体信息（可以同步到本地，定时维护，不用每次都去查询）： 请求参数： userid userpws cardid version 响应的XML标签说明 err_msg retcode ret_cardinfos 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 用户所需查询的商品 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 需查询商品的编码（支持4位，6位编码，4位表示该小类下的所有商品，6位是具体的商品信息） 固定值为：6.0 (不参与MD5验证) 调用的链接如下：

http://api2.ofpay.com/querycardinfo.do?userid=Axxxxx&userpws=xxxxxxx&cardid=2206&version=6.0

机密 第 5 页 共 47 页

欧飞SP合作接口文档

userid userpws cardid cardnum sporder_id sporder_time game_userid game_userpsw game_area game_srv md5_str ret_url version SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 所需提货商品的编码(需和CP商品编码一一对应,需22开头的编码) 所需提货商品的数量（1-10张） Sp商家的订单号 订单时间 （yyyyMMddHHmmss 如：20070323140214） 游戏玩家账号(game_userid=xxx@162.com$xxx001 xxx@162.com是通行证xxx001是玩家账号) 游戏玩家的密码（可以为空，并且不参与MD5验算） 游戏所在区域（没有则不填,需按CP要求填写） 游戏所在服务器组（没有则不填,需按CP要求填写） MD5后字符串 订单充值成功后返回的URL地址，可为空（不参与MD5验算）请使用80端口 固定值为：6.0 (不参与MD5验证) 买家IP(不参与MD5验证，当此参数有值时，此值userip 响应的XML标签说明 err_msg retcode orderinfo 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 CP返回的订单信息 作为订单来源IP存入库) md5_str检验码的计算方法: 包体=userid+userpws+cardid+cardnum+sporder_id+sporder_time+ game_userid+ game_area+ game_srv

1: 对: “包体+KeyStr” 这个串进行md5 的32位值. 结果大写 2: KeyStr 默认为 OFCARD, 实际上线时可以修改。 3: KeyStr 不在接口间进行传送。

调用的链接如下：

http://api2.ofpay.com/onlineorder.do?userid=Axxxxx&userpws=xxxxxxx&cardid=360101&cardnum=1&sporder_id=xxxxxxxxx&sporder_time=xxxxxxxx&game_userid=xxxxx&game_area=xxxxxx&game_srv=xxxxx&md5_str=xxxxxxxxxxxxx&version=6.0

以上参数如果是中文，需将参数值URL编码传递（GBK）

ret_url不为空时，系统将在充值成功时，发送成功信息到ret_url地址： 例：

ret_url =http://www.xxxx.com/retonline.jsp SP商户提供

系统请求参数：ret_code 充值后状态，1代表成功，9代表撤消

sporder_id SP订单号

ordersuccesstime 处理时间(yyyyMMddHHmmss) err_msg 失败原因 提交方式为：POST

注：SP得到请求信息后，请自行处理系统订单状态。如SP系统问题没收到返回结果，或者在长时间内没

机密 第 11 页 共 47 页

欧飞SP合作接口文档

有收到充值成功信息，可再次发送此笔订单到查询接口查看充值状态（SP订单号为原订单号），如还是没有充值成功请和CP客服联系，以做进一步处理。 返回的内容：

1

S0703300003 221201 1 1

剑侠情缘II15元直充 2443 ybb 三区 天下一家

0 //如果成功将为1，澈消(充值失败)为9，充值中为0,只

能当状态为9时，商户才可以退款给用户。

11手机号码归属地查询（mobinfo.do）

此接口用于查询手机号码的归属地： 请求参数： mobilenum 手机号码前七位 说明 例：http://api2.ofpay.com/mobinfo.do?mobilenum=1381383

返回：1381383|江苏南京|移动全球通卡

12查询手机号当时是否可以充值（telcheck.do）

http://api2.ofpay.com/telcheck.do?phoneno=13813856456&price=50&userid=Axxxxx

price为充值面值、userid为会员编号

机密

第 12 页 共 47 页

欧飞SP合作接口文档

返回：1#成功#0000&江苏南京 1表示能充值，其它表示不能充。

13根据手机号和面值查询商品信息（telquery.do）

此接口用于查询手机号是否能充值，如果能充值返回商品信息，不能充返回运营商维护

请求参数： userid userpws phoneno pervalue 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 手机号 快充可选面值（1、2、5、10、20、30、50、100、300） 慢充可选面值（30、50、100） 慢充类型：0.5（半小时到账）、4（4小时到账）、12（12小时到账）、 24（24小时到账）、48（48小时到账）、72（72小时到账） 商品类型：17 （慢充）、23 （流量包） 固定值为：6.0 (不参与MD5验证) mctype（慢充才传） cardtype version 请求URL为：

http://api2.ofpay.com/telquery.do?userid=Axxxxx&userpws=xxxxx&phoneno=xxxxx&pervalue=xx

&version=6.0 返回的内容：

成功

运营商地区维护，暂不能充值 11 1 141403

江苏移动充值50元 50

江苏南京移动

机密

第 13 页 共 47 页

欧飞SP合作接口文档

14手机直充接口（onlineorder.do）

此接口依据用户提供的请求为指定手机直接充值，这个接口和游戏直充使用同一个接口： 请求参数： userid userpws 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 所需提货商品的编码 (快充：140101，慢充：170101，流量充值：230101 )这里商品编码是模糊匹配只匹配前两位 快充可选面值（1、2、5、10、20、30、50、100、200、300、500） 慢充可选面值（30、50、100） 慢充类型：0.5（半小时到账）、4（4小时到账）、12（12小时到账）、 24（24小时到账）、48（48小时到账）、72（72小时到账） （不传默认为24，不参与MD5验证） Sp商家的订单号 订单时间 （yyyyMMddHHmmss 如：20070323140214） 手机号 MD5后字符串 订单充值成功后返回的URL地址，可为空（不参与MD5验算） 固定值为：6.0 (不参与MD5验证) cardid cardnum mctype sporder_id sporder_time game_userid md5_str ret_url version md5_str检验码的计算方法: 包体=userid+userpws+cardid+cardnum+sporder_id+sporder_time+ game_userid

1: 对: “包体+KeyStr” 这个串进行md5 的32位值. 结果大写 2: KeyStr 默认为 OFCARD, 实际上线时可以修改。 3: KeyStr 不在接口间进行传送。

调用的链接如下：

http://api2.ofpay.com/onlineorder.do?userid=Axxxxx&userpws=xxxxxxx&cardid=140101&cardnum=1&sporder_id=xxxxxxxxx&sporder_time=xxxxxxxx&game_userid=xxxxx&md5_str=xxxxxxxxxxxxx&ret_url=xxxxx&versi

on=6.0

以上参数如果是中文，需将参数值URL编码传递（GBK）

ret_url不为空时，系统将在充值成功时，发送成功信息到ret_url地址： 例：

ret_url =http://www.xxxx.com/retonline.jsp SP商户提供

系统请求参数：ret_code 充值后状态，1代表成功，9代表撤消

sporder_id SP订单号 ordersuccesstime 处理时间

err_msg 失败原因(ret_code为1时，该值为空) 提交方式为：POST

注：SP得到请求信息后，请自行处理系统订单状态。如SP系统问题没收到返回结果，或者在长时间内没有收到充值成功信息，可再次发送此笔订单到查询接口查看充值状态（SP订单号为原订单号），如还是没有充值成功请和CP客服联系，以做进一步处理。

机密 第 14 页 共 47 页

欧飞SP合作接口文档

返回的内容：

1

S0703300003 142303 1 99.8

江苏移动100元充值 200912180001 13813834333

0 //如果成功将为1，澈消(充值失败)为9，充值中为0,只

能当状态为9时，商户才可以退款给用户。

15根据固话/宽带号码和面值查询商品信息（fixtelquery.do）

此接口用于查询固话是否能充值，如果能充值返回商品信息，不能充返回运营商维护

请求参数： userid userpws teltype phoneno pervalue version chargeType 请求URL为：

说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 运营商 1、电信 2、联通（不传默认为1） 固话号码 （格式：021-88888888） 面值 （电信：10、20、30、50、100、300，联通：50、100） 固定值为：6.0 (不参与MD5验证) 充值类型 （可选：1：固话；2：宽带；默认为固话） http://api2.ofpay.com/fixtelquery.do?userid=Axxxxx&userpws=xxxxx&teltype=1&phoneno=xxxxx&

pervalue=xx&version=6.0

返回的内容：

成功

1 191103

机密 第 15 页 共 47 页

欧飞SP合作接口文档

上海电信CDMA固话充值 50元 49.4

上海上海电信

运营商地区维护，暂不能充值 11

16固话/宽带直充接口（fixtelorder.do）

此接口依据用户提供的请求为指定固话直接充值： 请求参数： userid userpws cardnum teltype chargeType sporder_id sporder_time game_userid md5_str ret_url version 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 购买面值（电信：10、20、30、50、100、300，联通：50、100） 运营商 1、电信 2、联通（不传默认为1，不参与MD5验证） 充值类型 （可选：1：固话；2：宽带；默认为固话） Sp商家的订单号 订单时间 （yyyyMMddHHmmss 如：20070323140214） 固话号码 （格式：021-88888888），宽带号码为区号后3到10位数字或者字母(备注：暂不支持含字母的宽带账号) MD5后字符串 订单充值成功后返回的URL地址，可为空（不参与MD5验算） 固定值为：6.0 (不参与MD5验证) md5_str检验码的计算方法: 包体=userid+userpws+cardnum+sporder_id+sporder_time+ game_userid

1: 对: “包体+KeyStr” 这个串进行md5 的32位值. 结果大写 2: KeyStr 默认为 OFCARD, 实际上线时可以修改。

3: KeyStr 不在接口间进行传送。 调用的链接如下：

http://api2.ofpay.com/fixtelorder.do?userid=Axxxxx&userpws=xxxxxxx&cardnum=50&teltype=1&sporder_id=xxxxxxxxx&sporder_time=xxxxxxxx&game_userid=xxxxx&md5_str=xxxxxxxxxxxxx&ret_url=xxxxx&version=6.0

以上参数如果是中文，需将参数值URL编码传递

ret_url不为空时，系统将在充值成功时，发送成功信息到ret_url地址： 例：

机密 第 16 页 共 47 页

欧飞SP合作接口文档

ret_url =http://www.xxxx.com/retonline.jsp SP商户提供

系统请求参数：ret_code 充值后状态，1代表成功，9代表撤消

sporder_id SP订单号 ordersuccesstime 处理时间

err_msg 失败原因(ret_code为1时，该值为空) 提交方式为：POST

注：SP得到请求信息后，请自行处理系统订单状态。如SP系统问题没收到返回结果，或者在长时间内没有收到充值成功信息，可再次发送此笔订单到查询接口查看充值状态（SP订单号为原订单号），如还是没有充值成功请和CP客服联系，以做进一步处理。

返回的内容：

1

S0703300003 191103 1 49.4

上海电信CDMA固话充值 50元 200912180001 021-12345678

0 //如果成功将为1，澈消(充值失败)为9，充值中为0,只

能当状态为9时，商户才可以退款给用户。

17根据SP订单号查询充值状态(api/query.do)

此接口用于查询订单的充值状态： 请求参数： userid spbillid SP编码如（A00001） Sp000001,商户系统订单号 说明 调用的链接如下：

http://api2.ofpay.com/api/query.do?userid=xxxxx&spbillid=spxxxxxx

返回（1，0，9，-1），其中一项。 1充值成功，0充值中，9充值失败，-1找不到此订单。如果返回-1，请您务必进入平台或者联系欧飞客服进行核实，避免给自己带来不必要的损失。

18自动对账接口（querybill.do）

此接口给SP进行交易记录查询以帮助SP实现自动对帐（三天之内）：

机密

第 17 页 共 47 页

欧飞SP合作接口文档

请求参数： userid userpws cardid starttime endtime md5_str version 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 所需提货商品的编码（支持2位，4位和6位），不填为全部 开始时间 （yyyyMMdd 如：20070323） 结束时间 （yyyyMMdd 如：20070323） 验证字符串 (32位大写) 固定值为：6.0 (不参与MD5验证) Md5_str=md5(userid+userpws+cardid+starttime+endtime+key) 调用的链接如下： http://api2.ofpay.com/querybill.do?userid=Axxxx&userpws=xxxxxxx&cardid=360101&starttime =xxxxxxxxx&endtime=xxxxxxxx&md5_str=xxxxxxxxxxxxx&version=6.0

返回的内容：

CP流水号|SP订单号|商品编号|商品数量|充值账号|订单金额|订单时间|订单状态 S0704020968|1|360101|1||0.01|2007-04-02 17:56:10|1 S0703230929|2|360101|1||0.01|2007-03-23 16:56:07|1 S0703230888|3|360101|1||0.01|2007-03-23 16:40:54|1 S0703230777|4|360101|1||0.01|2007-03-23 15:51:57|1 订单总数:932|订单总额:123123.222

19根据SP订单号补发充值状态(只补发最近三天内订单)（reissue.do）

此接口用于没有接收到回调充值状态的情况下进行补发： 请求参数： userid userpws spbillid version 请求URL为： 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) Sp000001,商户系统订单号 固定值为：6.0 (不参与MD5验证) http://api2.ofpay.com/reissue.do?userid=Axxxxx&userpws=xxxxx&spbillid=xxxx&version=6.0

返回的内容：

补发成功 1

机密 第 18 页 共 47 页

欧飞SP合作接口文档

20身份证核查接口（idcardquery.do）（此接口停用）

请求参数： userid userpws sporder_id sporder_time idcard name md5_str version 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) Sp商家的订单号 订单时间 （yyyyMMddHHmmss 如：20070323140214） 身份证号码 姓名 MD5后字符串 固定值为：6.0 (不参与MD5验证) md5_str检验码的计算方法: 包体=userid+userpws+sporder_id+sporder_time+idcard+name

1: 对: “包体+KeyStr” 这个串进行md5 的32位值. 结果大写 2: KeyStr 在测试阶段先选择为 OFCARD, 实际上线时再修改。

3: KeyStr 不在接口间进行传送。 调用的链接如下：

http://api2.ofpay.com/idcardquery.do?userid=Axxxxx&userpws=xxxxxxx&sporder_id=xxxxxxxxx&sporder_time=xxxxxxxx&idcard=xxxxx&name=xxxxx&md5_str=xxxxxxxxxxxxx&version=6.0

返回的内容：

1

S1204181290002 390101 1 4.300

身份证核查

200912180001 xxx //身份证号码 xxx //姓名

姓名一致，身份证号一致 //核查结果

http://www.ofcard.com/nciisimage.jsp?billid=xx&userid=xxx

//照片链接地址

1 //如果成功将为1，澈消(充值失败)为9，充值中为0,只

能当状态为9时，商户才可以退款给用户。

第 19 页 共 47 页

机密

欧飞SP合作接口文档

21支付宝充值接口 （onlineorder.do）

单笔限额1000(元)，每个手机号每日只能接收三次充值码。 支付宝卡直充账号需实名认证，每年5000元。

此接口依据用户提供的请求为支付宝账号直接充值 请求参数： userid userpws cardid cardnum sporder_id sporder_time game_userid actprice md5_str ret_url version 响应的XML标签说明 err_msg retcode orderinfo 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 CP返回的订单信息 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 固定值为：6102800(充值码) 6102100(支付宝卡直充) 固定值为：1 Sp商家的订单号 订单时间 （yyyyMMddHHmmss 如：20070323140214） 支付宝账户充值手机号(若是支付宝码充值，传手机号) 充值金额,格式 100.0 小数点保留1位 (不参与MD5验证) MD5后字符串 订单充值成功后返回的URL地址，可为空（不参与MD5验算）请使用80端口 固定值为：6.0 (不参与MD5验证) md5_str检验码的计算方法:

包体=userid+userpws+cardid+cardnum+sporder_id+sporder_time+ game_userid

1: 对: “包体+KeyStr” 这个串进行md5 的32位值. 结果大写 2: KeyStr 默认为 OFCARD, 实际上线时可以修改。 3: KeyStr 不在接口间进行传送。

调用的链接如下：

http://api2.ofpay.com/onlineorder.do?userid=Axxxxx&userpws=xxxxxxx&cardid=6102100&cardnum=1&sporder_id=xxxxxxxxx&sporder_time=xxxxxxxx&game_userid=xxxxx&actprice=xxxxxx&md5_str=xxxxxxxxxxxxx&version=6.0

ret_url不为空时，系统将在充值成功时，发送成功信息到ret_url地址： 例：

ret_url =http://www.xxxx.com/retonline.jsp SP商户提供

系统请求参数：ret_code 充值后状态，1代表成功，9代表撤消

机密 第 20 页 共 47 页

欧飞SP合作接口文档

sporder_id SP订单号 ordersuccesstime 处理时间 err_msg 失败原因 提交方式为：POST

注：SP得到请求信息后，请自行处理系统订单状态。如SP系统问题没收到返回结果，或者在长时间内没有收到充值成功信息，可再次发送此笔订单到查询接口查看充值状态（SP订单号为原订单号），如还是没有充值成功请和CP客服联系，以做进一步处理。 返回的内容：

1

S0703300003 6102800 1 1

支付宝充值码充值 2443

13775611111

4832960052667952 //支付宝充值码

0 //如果成功将为1，澈消(充值失败)为9，充值中为0,只

能当状态为9时，商户才可以退款给用户。

22 更新用户秘钥(modifyuserkey.do)

此接口用于更新用户秘钥信息 请求参数： userid userpws version newKey md5_str 说明： md5_str检验码的计算方法: 包体=userid+userpws+newKey

1: 对: “包体+oldKey” 这个串进行md5 的32位值. 结果大写

2: oldKey为用户旧的秘钥，默认为 OFCARD, 实际上线时可以修改。 3: oldKey不在接口间进行传送。 4:使用GBK编码进行MD5 响应的XML标签说明 err_msg 说明 错误描述，如请求得到正确返回，此处将为空 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 固定值为：6.0 (不参与MD5验证) (*必填) 新秘钥，将用户的秘钥更新为此 (*必填) Md5验证字符串 (*必填) 机密 第 21 页 共 47 页

欧飞SP合作接口文档

retcode 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回

调用的链接如下：

http://api2.ofpay.com/modifyuserkey.do?userid=A08566&userpws=*************&version=6.0&newKey=123&md5_str=50F7B67C57173A6CEF442C5A2C7E3570 返回的内容：

1 //1:表示修改秘钥成功，其他为失败 A08566

23 公共事业省份查询接口(getProvinceList.do) 此接口用于公共事业充值查询省份

请求参数： userid userpws version 响应的XML标签说明 err_msg retcode provinceId provinceName 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 省份编号 省份名称 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 固定值为：6.0 (*必填) 调用的链接如下：

http://api2.ofpay.com/getProvinceList.do?userid=A*****&userpws=******************************&version=6.0

返回的内容：

1

v1918

湖南

v1933

四川

机密 第 22 页 共 47 页

欧飞SP合作接口文档

v1953

北京

24 公共事业城市查询接口(getCityList.do)

此接口用于公共事业充值，根据省份ID获取支持的城市

请求参数： userid userpws provId version 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 省份ID (*必填) 固定值为：6.0 (*必填)

响应的XML标签说明 err_msg retcode provinceId cityId cityName 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 省份编号 城市编号 城市名称

调用的链接如下：

http://api2.ofpay.com/getCityList.do?userid=A*****&userpws=**************&version=6.0&provId=v2056 返回的内容：

1

v2056 v2057

常州

v2056 v2058

南京

机密 第 23 页 共 47 页

欧飞SP合作接口文档

25 公共事业充值类型查询接口(getPayProjectList.do)

此接口用户公共事业充值，根据省份ID、城市ID获取支持的充值类型(水、电、煤)

请求参数： userid userpws provId cityId version

说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 省份ID (*必填) 城市ID (*必填) 固定值为：6.0 (*必填) 响应的XML标签说明 err_msg retcode provinceId cityId payProjectId payProjectName

说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 省份编号 城市编号 缴费类型编号 缴费类型名称 调用的链接如下：

http://api2.ofpay.com/getPayProjectList.do?userid=A****&userpws=************&version=6.0&provId=v2056&cityId=v2058 返回的内容：

1

v2056 v2058

c2670

水费

机密 第 24 页 共 47 页

欧飞SP合作接口文档

v2056 v2058

c2680

电费

v2056 v2058

c2681

燃气费

26 公共事业缴费单位查询接口(getPayUnitList.do)

此接口用户公共事业充值，根据省份ID、城市ID、充值类型获取支持的缴费单位。

请求参数： userid userpws provId cityId type version

说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 省份ID (*必填) 城市ID (*必填) 缴费类型编号 固定值为：6.0 (*必填) 响应的XML标签说明 err_msg retcode provinceId cityId payProjectId payUnitId payUnitName

说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 省份编号 城市编号 缴费类型编号 缴费单位编码 缴费单位名称 机密 第 25 页 共 47 页

欧飞SP合作接口文档

调用的链接如下：

http://api2.ofpay.com/getPayUnitList.do?userid=A****&userpws=*****************&version=6.0&provId=v2056&cityId=v2058&type=c2670

返回的内容：

1

v2056 v2058

c2670 v2351

南京市自来水总公司

27 水电煤商品信息查询接口(queryClassId.do)

此接口用户公共事业充值，根据省份ID、城市ID、充值类型、缴费单位 获取水电煤商品信息

请求参数： userid userpws provId cityId type chargeCompanyCode version

说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 省份ID (*必填) 城市ID (*必填) 缴费类型编码 (*必填) 缴费单位编码 (*必填) 固定值为：6.0 (*必填) 响应的XML标签说明 err_msg retcode productId productName 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 商品编号 商品名称 机密 第 26 页 共 47 页

欧飞SP合作接口文档

inprice

商品售价 调用的链接如下：

http://api2.ofpay.com/queryClassId.do?userid=A****&userpws=********************&version=6.0&provId=v2056&cityId=v2058&type=c2670&chargeCompanyCode=v2351 返回的内容：

1

6439500

江苏南京 南京市港华燃气公司 燃气费户号 任意充直充 1

28 水电煤账户欠费查询接口(queryBalance.do) 此接口用公共事业充值，查询账户欠费金额

请求参数： userid userpws provName cityName type chargeCompanyCode chargeCompanyName account cardId version

说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 省份名称 (*必填) （用URLEncode编码指定字符集GBK） 城市名称 (*必填) （用URLEncode编码指定字符集GBK） 类型（001：水费、002：电费、003：燃气费） 缴费单位编码 (*必填) 缴费单位名称 (*必填) （用URLEncode编码指定字符集GBK） 水电煤充值账户 (*必填) 水电煤的商品编号 (*必填) 固定值为：6.0 (*必填) 响应的XML标签说明 err_msg retcode userCode 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 用户编号 机密 第 27 页 共 47 页

欧飞SP合作接口文档

account accountName balance contractNo

缴费帐号 用户姓名 欠费信息 合同号 （查到才返回） 调用的链接如下：

http://api2.ofpay.com/queryBalance.do?userid=A08566&userpws=4c625b7861a92c7971cd2029c2fd3c4a&version=6.0&cityName=????&type=001&chargeCompanyCode=v2351&account=9033841019& provName=xxx& chargeCompanyName=xxxx&cardId=xxxx 返回的内容：

1

A08566 9033841019 汪*友

查询失败原因:[0007不在正常的缴费日期内，不能缴费] 201409231656086745037160140923173275

29 公共事业充值(utilityOrder.do)

此接口用于根据用户的请求生成水电煤的订单。 请求参数： userid userpws provId cityId type chargeCompanyCode version cardId cardnum account contractNo ret_url md5_str sporderId actPrice 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 省份ID (*必填) 城市ID (*必填) 类型 缴费单位编码 (*必填) 固定值为：6.0 (*必填) 水电煤的商品编号 (*必填) 充值数量 (*必填)，充值数量始终为1 水电煤充值账户 (*必填) 合同号 回调地址 MD签名串 (*必填) 外部订单号 (*必填) 充值金额（单位：元，保留小数点后2位），例如198.35元 机密 第 28 页 共 47 页

欧飞SP合作接口文档

md5_str检验码的计算方法:

包体=userid+userpws+cardid+cardnum+sporderId+provId+cityId+type+chargeCompanyCode+account

1: 对: “包体+KeyStr” 这个串进行md5 的32位值. 结果大写 2: KeyStr 默认为 OFCARD, 实际上线时可以修改。 3: KeyStr 不在接口间进行传送。

调用的链接如下：

http://api2.ofpay.com/utilityOrder.do?userid=xxxxx&userpws=xxxxx&provId=xxxxx&cityId=xxxxx&type=xxxxxx&chargeCompanyCode=xxxxx&version=xxxx&cardId=xxxxx&cardnum=xxxxx&account=xxxxxx&ret_url=x

xxxx&sporderId=xxxxxx&md5_str=xxxxx&actPrice=xxxx&contractNo=xxxxxx

ret_url不为空时，系统将在充值成功时，发送成功信息到ret_url地址： 例：

ret_url =http://www.xxxx.com/retonline.jsp SP商户提供

系统请求参数：ret_code 充值后状态，1代表成功，9代表撤消

sporder_id SP订单号 ordersuccesstime 处理时间

err_msg 失败原因(ret_code为1时，该值为空) 提交方式为：POST

注：SP得到请求信息后，请自行处理系统订单状态。如SP系统问题没收到返回结果，或者在长时间内没有收到充值成功信息，可再次发送此笔订单到查询接口查看充值状态（SP订单号为原订单号），如还是没有充值成功请和CP客服联系，以做进一步处理。

返回的内容：

1

S1403270532562//欧飞订单号 151403 1 49.4

江苏南京 南京市自来水公司 水费户号 任意充直充 2014032700005 //订单编号 9033841019 //充值账号

0 //如果成功将为1，澈消(充值失败)为9，充值中为0,只能当状态为9时，商户才可以退款给用户。

30加油卡充值接口 （sinopec/onlineorder.do）

请求参数： userid 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 机密 第 29 页 共 47 页

欧飞SP合作接口文档

userpws SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 64127500（中石化任意充）、64157002（中石化直充500元）、64157001（中石化直充1000元） 64157004(中石化直充100元) 64313604(中石化卡密100元, 备注:用第8个接口提取卡密信息) 64313602(中石化卡密500元, 备注:用第8个接口提取卡密信息) 64313601(中石化卡密1000元, 备注:用第8个接口提取卡密信息) 64349102(（中石油任意充） 充值数量 任意充 （整数（元）），其余面值固定值为1 Sp商家的订单号 订单时间 （yyyyMMddHHmmss 如：20070323140214） 加油卡号（充值账号）中石化：以100011开头后面13位、中石油：以9开头后面15位 加油卡类型 （1:中石化、2:中石油；默认为1，不参与MD5校验） 持卡人手机号码(必填) 持卡人姓名(可为空) MD5后字符串 订单充值成功后返回的URL地址，可为空（不参与MD5验算）请使用80端口 固定值为：6.0 (不参与MD5验证) 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 CP返回的订单信息 cardid cardnum sporder_id sporder_time game_userid chargeType gasCardTel gasCardName md5_str ret_url version 响应的XML标签说明 err_msg retcode orderinfo md5_str检验码的计算方法:

包体=userid+userpws+cardid+cardnum+sporder_id+sporder_time+ game_userid

1: 对: “包体+KeyStr” 这个串进行md5 的32位值. 结果大写 2: KeyStr 默认为 OFCARD, 实际上线时可以修改。 3: KeyStr 不在接口间进行传送。

调用的链接如下：

http://api2.ofpay.com/sinopec/onlineorder.do?userid=A0****&userpws=4c625b7861a*******9c2fd3c4a&cardid=6******&cardnum=2&sporder_id=sinopecorder&sporder_time=20070323140214&game_userid=123456&ret_url=http://www.http://www.wodefanwen.com/&version=6.0&md5_str=89D4AB082C*****2471E188713DCBF67&gasCardTel=159****6144&gasCardName=test

ret_url不为空时，系统将在充值成功时，发送成功信息到ret_url地址： 例：

ret_url =http://www.xxxx.com/retonline.jsp SP商户提供

系统请求参数：ret_code 充值后状态，1代表成功，9代表撤消

机密 第 30 页 共 47 页

欧飞SP合作接口文档

sporder_id SP订单号 ordersuccesstime 处理时间 err_msg 失败原因 提交方式为：POST

注：SP得到请求信息后，请自行处理系统订单状态。如SP系统问题没收到返回结果，或者在长时间内没有收到充值成功信息，可再次发送此笔订单到查询接口查看充值状态（SP订单号为原订单号），如还是没有充值成功请和CP客服联系，以做进一步处理。 返回的内容：

1

S1404150533235

6444600 2 222

江苏中石化加油充值卡 100元直充 sinopecorder 123456

0//如果成功将为1，澈消(充值失败)为9，充值中为0,只能当状

态为9时，商户才可以退款给用户。

31加油卡卡号信息查询 （sinopec/queryCardInfo.do）

请求参数： userid userpws game_userid chargeType md5_str version 响应的XML标签说明 err_msg retcode queryInfo 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 CP返回的卡号信息 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 加油卡号（充值账号）中石化：以100011开头后面13位、中石油：以9开头后面15位 加油卡类型 （1:中石化、2:中石油；默认为1，不参与MD5校验） MD5后字符串 固定值为：6.0 (不参与MD5验证) md5_str检验码的计算方法: 包体=userid+userpws+game_userid

1: 对: “包体+KeyStr” 这个串进行md5 的32位值. 结果大写

机密 第 31 页 共 47 页

欧飞SP合作接口文档

2: KeyStr 默认为 OFCARD, 实际上线时可以修改。 3: KeyStr 不在接口间进行传送。

调用的链接如下：

http://api2.ofpay.com/sinopec/queryCardInfo.do?userid=A0****&userpws=4c625b7861a*******9c2fd3c4a&game_userid=xxxxxxx&version=6.0&md5_str=xxxxxxx

返回的内容：

1

1000113200006632588 * 东萍

32苹果app充值，获取所有游戏列表(getGameList.do) 此接口用于获取苹果app充值的游戏列表

请求参数： userid userpws version 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 固定值为：6.0 (*必填) 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 游戏编号 游戏名称 游戏首字母 响应的XML标签说明 err_msg retcode gameId gameName gameInitial 调用的链接如下：

http://api2.ofpay.com/apple/getGameList.do?userid=Axxxxx&userpws=xxxx&version=6.0 返回的内容：

1

A1102

冰火王座苹果版 B

机密 第 32 页 共 47 页

欧飞SP合作接口文档

A1000

部落冲突苹果版 B

33苹果app充值，获取游戏的版本信息(getGameVersion.do) 此接口用于苹果app充值，获取游戏的版本信息

请求参数： userid userpws version gameId 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 固定值为：6.0 (*必填) 游戏Id 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 游戏版本编号 游戏版本名称 响应的XML标签说明 err_msg retcode versionId versionName

调用的链接如下：

http://api2.ofpay.com/apple/getGameVersion.do?userid=Axxxxx&userpws=xxxxx&version=6.0&gameId=A1109

返回的内容：

1 A1109V01 微信版

机密 第 33 页 共 47 页

欧飞SP合作接口文档

A1109V02 QQ版

34苹果app充值，获取游戏的区信息(getGameArea.do) 此接口用于苹果app充值，获取游戏的区信息

请求参数： userid userpws version gameId 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 固定值为：6.0 (*必填) 游戏Id 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 游戏区编号 游戏区名称 响应的XML标签说明 err_msg retcode gameAreaId gameArea 调用的链接如下：

http://api2.ofpay.com/apple/getGameArea.do?userid=Axxxxx&userpws=xxxxx&version=6.0&gameId=A1049 返回的内容：

1

A1049P001 官方区

机密 第 34 页 共 47 页

欧飞SP合作接口文档

35苹果app充值，获取游戏的服信息(getGameServer.do) 此接口用于苹果app充值，获取充值商品的面值信息

请求参数： userid userpws version gameId areaId 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 固定值为：6.0 (*必填) 游戏Id 区Id 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 游戏服Id 游戏服名称 响应的XML标签说明 err_msg retcode serverId serverName 调用的链接如下：

http://api2.ofpay.com/apple/getGameServer.do?userid=Axxxxx&userpws=xxxxxx&version=6.0&gameId=A1049&areaId=A1049P001 返回的内容：

1

A1049P001001 全区全服

36苹果app充值，获取充值游戏商品面值信息(getGameFaceValue.do) 此接口用于苹果app充值，获取游戏的服信息

请求参数： userid userpws 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) (*必填) 机密 第 35 页 共 47 页

欧飞SP合作接口文档

version gameId areaId serverId 固定值为：6.0 (*必填) 游戏Id 区Id 服ID 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 商品面值 商品描述 商品编号 商品售价 响应的XML标签说明 err_msg retcode faceValue description goodsId inPrice

调用的链接如下：

http://api2.ofpay.com/apple/getGameFaceValue.do?userid=Axxxxx&userpws=xxxxxx&version=6.0&gameId=A1102&areaId=A1102P001&serverId=A1102P001010 返回的内容：

1

30

30元（150绿钻） 900559 30.000

198

198元（990绿钻） 900563 198.000

37苹果app充值，充值下单(appleGameOrder.do) 此接口用于苹果app充值，获取游戏的服信息

请求参数： userid userpws 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 (*必填) SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为机密 第 36 页 共 47 页

欧飞SP合作接口文档

md5(“111111”) (32位小写) (*必填) version gameId versionId areaId serverId cardNum gameAccount gamePwd roleName roleLevel mobileNo parValue sporderId retUrl sign 固定值为：6.0 (*必填) 游戏Id (*必填) 游戏版本ID(*必填) 区Id (*必填) 服ID (*必填) 充值数量 (*必填) 充值游戏账号 (*必填) 充值游戏账号密码 (*必填) 角色名称 (*必填) 角色等级 手机号 面值 (*必填) 商户订单号 (*必填) 回调地址 签名串 (*必填) 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 欧飞订单号 商品编号 购买数量 购买总价 商品名称 商户订单号 充值账号 充值状态 响应的XML标签说明 err_msg retcode orderid cardid cardnum ordercash cardname sporderId account status Sign签名串的计算方法:

包体=userid+userpws+cardNum+sporderId+gameAccount+areaId+serverId

1: 对: “包体+KeyStr” 这个串进行md5 的32位值. 结果大写 2: KeyStr 默认为 OFCARD, 实际上线时可以修改。 3: KeyStr 不在接口间进行传送。

retUrl不为空时，系统将在充值成功时，发送成功信息到retUrl地址： 例：

ret_url =http://www.xxxx.com/retonline.jsp SP商户提供

系统请求参数：ret_code 充值后状态，1代表成功，9代表撤消

sporder_id SP订单号 ordersuccesstime 处理时间 err_msg 失败原因 提交方式为：POST

注：SP得到请求信息后，请自行处理系统订单状态。如SP系统问题没收到返回结果，或者在长时间内没有收到充值成功信息，可再次发送此笔订单到查询接口查看充值状态（SP订单号为原订单号），如还是没

机密 第 37 页 共 47 页

欧飞SP合作接口文档

有充值成功请和CP客服联系，以做进一步处理。

调用的链接如下：

http://api2.ofpay.com/apple/appleGameOrder.do?userid=Axxxxx&userpws=xxxxxx&version=6.0&gameId=A1102&versionId=A1102V01&areaId=A1102P001&serverId=A1102P001010&cardNum=10&gameAccount=1122233333&gamePwd=11222121&roleName=of111111&roleLevel=of111111&mobileNo=18626468909&parValue=30&sporderId=lsh-2014042200005&sign=A842A3ED95DFE9AA9B8DEB8D7455F455&retUrl=www.http://m.njliaohua.com/ 返回的内容： 1 S1404230533531 2700000 300 300 苹果手游任意充直充 lsh-2014042200005 1122233333 0 //如果成功将为1，澈消(充值失败)为9，充值中为0,只能当状态为9时，商户才可以退款给用户。

38私有库存提卡接口（privateOrder.do）

此接口依据用户提供的商品订单号返回卡密信息并且提出自己私有的卡密： 请求参数： userid userpws sporder_id sporder_time cardid cardnum md5_str version 响应的XML标签说明 err_msg retcode ret_msg 说明 错误描述，如请求得到正确返回，此处将为空 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 返回的撤销信息 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) Sp自定义的订单号(唯一性) 订单时间 （yyyyMMddHHmmss 如：20070323140214） 所需提货商品的编码(需和CP商品编码一一对应,) 所需提货商品的数量 cardnum不传默认为1 MD5之后字符串 固定值为：6.0 (不参与MD5验证) md5_str检验码的计算方法: 包体=userid+userpws+cardid+cardnum+sporder_id+sporder_time

1: 对: “包体+KeyStr” 这个串进行md5 的32位值. 结果大写 2: KeyStr 默认为 OFCARD, 实际上线时可以修改。

机密 第 38 页 共 47 页

欧飞SP合作接口文档

3: KeyStr 不在接口间进行传送。

调用的链接如下：

http://api2.ofpay.com/privateOrder.do?userid=Axxxxx&userpws=xxxxxxx&sporder_id=xxxxxxxx&sportder_time=xxxxx&cardid=xxxx&cardnum=xxx&md5_str=xxxxx&version=6.0

返回的内容：

1

xxxxxxx 360101

test12345 1

xxxxxx

xxxxxxx

失败返回

MD5串验证错误 1003

39流量直充接口（flowOrder.do）

此接口依据用户提供的请求为指定手机充值流量： 请求参数： userid userpws phoneno perValue 说明 SP编码如（A00001）在登陆系统时得到以A开头的编号 SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) 充值手机号 面值 机密 第 39 页 共 47 页

欧飞SP合作接口文档

flowValue range effectStartTime effectTime netType sporderId md5Str retUrl version 流量值 （10M、20M、30M、50M、60M、70M、80M、100M、150M、200M、280M、300M、400M、500M、600M、1G、2G、5G） 使用范围 1（省内）、 2（全国） 生效时间 1（当日）、2（次日）、3（次月） 有效期 1（当月有效） 网络制式 2G、3G、4G Sp商家的订单号 MD5后字符串 订单充值成功后返回的URL地址，可为空（不参与MD5验算） 固定值为：6.0 (不参与MD5验证) md5Str检验码的计算方法:

包体= userid + userpws + phoneno + perValue + flowValue + range + effectStartTime + effectTime + netType + sporderId

1: 对: “包体+KeyStr” 这个串进行md5 的32位值. 结果大写 2: KeyStr 默认为 OFCARD, 实际上线时可以修改。 3: KeyStr 不在接口间进行传送。

调用的链接如下：

http://api2.ofpay.com/flowOrder.do?userid=Axxxxx&userpws=xxxxxxx&phoneno=xxxx&perValue=xxx&flowValue=xxx&range=xxxx&effectStartTime=xxxxx&effectTime=xxx&netType=xxx&sporderId=xxxx&md5Str=xxxx &version=6.0&retUrl=xxx

以上参数如果是中文，需将参数值URL编码传递（GBK）

ret_url不为空时，系统将在充值成功时，发送成功信息到ret_url地址： 例：

ret_url =http://www.xxxx.com/retonline.jsp SP商户提供

系统请求参数：ret_code 充值后状态，1代表成功，9代表撤消

sporder_id SP订单号 ordersuccesstime 处理时间

err_msg 失败原因(ret_code为1时，该值为空) 提交方式为：POST

注：SP得到请求信息后，请自行处理系统订单状态。如SP系统问题没收到返回结果，或者在长时间内没有收到充值成功信息，可再次发送此笔订单到查询接口查看充值状态（SP订单号为原订单号），如还是没有充值成功请和CP客服联系，以做进一步处理。

返回的内容：

1

S1410140541452 1221601 1

机密 第 40 页 共 47 页

本文来源：https://www.bwwdw.com/article/pwo7.html