1、欧飞SP合作接口文档机密 第 1 页 共 47 页OFCARD 系统 http 接口协议(V6.10)本版本最后修订日期： 2015 年 4 月 10 日版本号 日期 说明 作者4.0 2008-12-15 增加版本号字段，SP 接入密码修改为账户密码的 MD5 值5.0 2009-5-7 增加游戏区服接口，开通电信手机充值5.1 2009-01-08 修正商品对应分类错误5.2 2010-7-13 增加买家 IP 字段5.3 2011-01-13 订单查询地址变动5.4 2011-08-23 接口域名变动（新接口用户启用）5.5 2011-09-26 增加移动慢充接口2011-09-28 增
2、加根据手机号和面值查询商品信息2012-04-18 增加身份证核查接口2012-05-26 增加固话查询和充值接口6.0 2012-09-26 修改版本号，修改手机直充可选面值6.1 2013-03-26 修改接口使用顺序、增加文档说明出现错误码时只返回错误码和错误描述6.2 2013-12-21 增加支付宝直充接口6.3 2014-4-23 新增中石化加油卡接口6.4 2014-4-28 新增苹果 APP 充值接口6.5 2014-07-12 新增私有库存接口6.6 2014-8-6 接口刷新:获取游戏的版本信息苹果 app 充值，充值下单6.7 2014-9-23 修改水电煤欠费查询接口增
3、加中石化加油卡卡号信息查询接口6.8 2014-10-14 增加流量充值接口6.9 2014-11-21 增加换卡接口、撤销接口、银行转账接口及查询接口6.9.1 2015-03-31 修改加油卡直充及查询接口6.10 2015-4-10 增加流量查询接口说明本文档供 SP 和本项目的后续开发维护人员使用，为了业务系统的安全，请严格不泄露本协议接口。欧飞SP合作接口文档机密 第 2 页 共 47 页在这个接口协议中，欧飞 OFCARD 作为内容供应商，我们称之为 CP，调用我们接口的商户作为一个业务点，我们称之为 SP。 通过接口 SP 能够根据需要从 CP 实时获得需要的商品信息，可以提取卡
4、密或者对帐号进行实时充值。本接口的业务逻辑基于欧飞 API 供货大接口（http:/ 使用该接口之前必须注册成经销商或者直销商，提供 SP 服务器 IP 地址，通知欧飞工作人员开通 Http接口功能，欧飞为你分配相应功能模块和 MD5 key 值，你的登陆密码不能设置的太简单，请不要向任何人，包括欧飞工作人员泄露你的直销系统登陆密码。欧飞针对本协议接口没有架设测试环境，拿到该接口的 SP，请直接进入生产环境（地址和端口详见各个功能模块）进行测试，SP 注册后可以自行购买一定数量的信用点（信用点可以理解成预存款，没有信用点的情况下，SP 无法进行提卡和充值），建议用编码为360101 的测试卡进
5、行提卡测试，用 Q 币进行充值测试。SP 可以登陆欧飞直销系统查看交易记录进行对帐，也可以使用对帐接口进行自动对帐。关于接口的另外几点说明：- 该接口使用 HTTP 协议，请求数据传输格式如下：【接口 URL】? 【参数名称 1】= 【参数值 1】userpws=111111;cardid=36;version=6.0返回的内容：- 1 - - 2303 / 小类商品编码 23 /此子类商品所属大类编码劲舞挂机宝贝 /小类商品名称 %B9%D2%BB%FA%B1%A6%B1%B4%CF%B5%C1%D0%CA%C7%D2%BB%BF%EE%C2%CC%C9%AB%B5%C4%CD%F8%D3%
6、CE%B欧飞SP合作接口文档机密 第 5 页 共 47 页8%A8%D6%FA%B9%A4%BE%DF%A3%AC%CB%FC%B2%C9%D3%C3 %AC%B1%BE%C8%ED%BC%FE%D7%F7%CE%AA%D2%BB%BF%EE%C2%CC%C9%AB%B5%C4%B9%A4%BE%DF%A3%AC%D6%BB%C6%F0%B5%BD%B8%A8%D6%FA%B5%C4%D7%F7%D3%C3%A1%A3 /商品介绍 35%D4%AA%2F%D4%C2 /资费说明 全国 /开通城市 %B3%E4%D6%B5%B5%D8%D6%B7%A3%Bahttp%3A%2F%2F%2Fcho
7、ngzhi.htm%3C%2Fbr%3E%0D%0A%B9%D9%B7%BD%CD%F8%D5%BE%A3%Bahttp%3A%2F%2F /使用方法 http:/ /充值网址中国 /产品产地 %C8%E7%B9%FB%C4%FA%D4%DA%B9%BA%C2%F2%D6%D0%D3%D0%CE%CA%CC%E2%C7%EB%BA%CD%CE%D2%C3%C7%C1%AA%CF%B5%A3%BA%0D%0A%BF%CD%B7%FEQQ%A3%BA393462%0D%0A%B5%E7%BB%B0%A3%BA025-52255777%0D%0Aemail%A3%Baservice%+%0D%0A%
8、C8%E7%D3%F6%B5%BD%B9%D9%B7%BD%CD%A3%D6%B9%B7%FE%CE%F1%A3%AC%B1%BE%CF%B5%CD%B3%B2%BB%B3%D0%B5%A3%C8%CE%BA%CE%D4%F0%C8%CE%A1%A3/客服服务中心 4 具体商品信息同步接口（querycardinfo.do）此接口依据用户提供的商品编码返回此商品的具体信息（可以同步到本地，定时维护，不用每次都去查询）：请求参数： 说明userid SP 编码如（A00001）在登陆系统时得到以 A 开头的编号userpws SP 接入密码( 为账户密码的 MD5 值，如登陆密码为 111111
9、,此时这个值为md5(“111111”) (32 位小写)cardid 需查询商品的编码（支持 4 位，6 位编码，4 位表示该小类下的所有商品，6 位是具体的商品信息）version 固定值为：6.0 (不参与 MD5 验证)响应的 XML 标签说明 说明欧飞SP合作接口文档机密 第 6 页 共 47 页err_msg 错误描述，如请求得到正确返回，此处将为空retcode 操作返回代码，1 成功,err_msg 为空，其它数字具体错误在 err_msg 返回ret_cardinfos 用户所需查询的商品调用的链接如下：http:/ 1 - - 220612 1 0.95 0.95 0.94
10、5 0.94 0.96 240 Q 币按元直充(点击购买更多面值) Q 币按元直充A1-10,15 /在线充产品可选数量，连续的用“-”表示，“,”用作分隔符2206/此商品所属子类编码2/此商品所属商品类型（1-实物商品，2-直充商品，3-卡密商品，4-手机快冲，5-手机慢冲，6-支付商品）例：如果可选值为”1-10,15,20,30”，那么可选数量为“1,2,3,4,5,6,7,8,9,10,15,20,30 ” http:/ q%B1%D2%B3%E4%D6%B5%CD%F8%D5%BE%CC%DA%D1%B6%B9%D9%CD%F8%%29%CA%C7%D6%D0%B9%FA%D7%E
11、E%D4%E7%B5%C4%BB%A5%C1%AA%CD%F8%BC%B4%CA%B1%CD%A8%D0%C5%C8%ED%BC%FE%BF%AA%B7%A2%C9%CC%A3%AC%CA%C7%D6%D0%B9%FA%B5%C4%BB%A5%C1%AA%CD%F8%B7%FE%CE%F1%BC%B0%D2%C6%B6%AF%D4%F6%D6%B5%B7%FE%CE%F1%B9%A9%D3%A6%C9%CC%A3%AC%B2%A2%D2%BB%D6%B1%D6%C2%C1%A6%D3%DA%BC%B4%CA%B1%CD%A8%D0%C5%BC%B0%CF%E0%B9%D8%D4%F6%D6%B
12、5%D2%B5%CE%F1%B5%C4%B7%FE%CE%F1%D4%CB%D3%AA%A1%A3%CC%DA%D1%B6%D2%D1%D0%CE%B3%C9%B8%F6%C8%CB%BC%B4%CA%B1%CD%A8%D0%C5%A1%A2%C6%F3%D2%B5%CA%B5%CA%B1%CD%A8%D0%C5%BA%CD%D3%E9%C0%D6%D7%CA%D1%B6%B5%C8%C8%FD%B4%F3%D5%BD%C2%D4%B7%A2%D5%B9%B7%BD%CF%F2%A3%AC%D5%FD%D6%F0%B2%BD%C欧飞SP合作接口文档机密 第 7 页 共 47 页A%B5%CF%
13、D6%A1%B0%B4%B4%D2%BB%C1%F7%BB%A5%C1%AA%CD%F8%C6%F3%D2%B5%A1%B1%B5%C4%D4%B6%BE%B0%C4%BF%B1%EA%A1%A3+%3CBR%3E%B9%BA%C2%F2%CA%B1%C7%EB%D7%A2%D2%E2%D5%FD%C8%B7%CA%E4%C8%EB%C4%FA%B5%C4QQ%BA%C5%C2%EB%2C%D2%BB%B8%F6QQ%BA%C5%C2%EB%D2%BB%CC%EC%D7%EE%B6%E0%BF%C9%D2%D4%B3%E4%D6%B55000Q%B1%D2%A3%AC%B5%A5%B4%CE%
14、B3%E4%D6%B5%B2%BB%C4%DC%B3%AC%B3%F6500Q%B1%D2%A1%A3 2008-06-10 09:46:46 /最后操作时间腾讯 QQ 号/账号描述5 商品价格查询接口（queryprice.do）此接口依据用户提供的商品编码返回此商品的价格信息请求参数： 说明userid SP 编码如（A00001）在登陆系统时得到以 A 开头的编号userpws SP 接入密码( 为账户密码的 MD5 值，如登陆密码为 111111,此时这个值为md5(“111111”) (32 位小写)cardid 需查询商品的编码version 固定值为：6.0 (不参与 MD5 验
15、证)响应的 XML 标签说明 说明err_msg 错误描述，如请求得到正确返回，此处将为空retcode 操作返回代码，1 成功,err_msg 为空，其它数字具体错误在 err_msg 返回ret_cardinfos 用户所需查询的商品调用的链接如下：http:/ - - 210102 /商品编号热血传奇 10 元卡 /商品名称10 /商品面值9.4 /对应 SP 等级的结算价欧飞SP合作接口文档机密 第 8 页 共 47 页9.4 /CP 系统 1 级直销价9.38 / CP 系统 2 级直销价9.36 / CP 系统 3 级直销价9.45 /普通会员价30 /商品库存情况1-10 /可选
16、数量6 查询商品最后修改时间（retmaxtime.do）此接口可以用于判断商品是否有修改，有修改则再次同步商品信息：请求参数： 说明cardid 商品编号例：http:/ 14:51:067 卡密商品库存查询接口（queryleftcardnum.do）此接口依据用户提供的商品编码返回此商品的说明信息：请求参数： 说明userid SP 编码如（A00001）在登陆系统时得到以 A 开头的编号userpws SP 接入密码( 为账户密码的 MD5 值，如登陆密码为 111111,此时这个值为md5(“111111”) (32 位小写)cardid 需查询商品的编码version 固定值为：6
17、.0 (不参与 MD5 验证)响应的 XML 标签说明 说明err_msg 错误描述，如请求得到正确返回，此处将为空retcode 操作返回代码，1 成功,err_msg 为空，其它数字具体错误在 err_msg 返回ret_cardinfos 用户所需查询的商品调用的链接如下：http:/ - 欧飞SP合作接口文档机密 第 9 页 共 47 页- 3102020 /商品库存情况1-10,15 /在线充产品可选数量，连续的用“-”表示，“,”用作分隔符例：如果可选值为”1-10,15,20,30”，那么可选数量为“1,2,3,4,5,6,7,8,9,10,15,20,30 ”8 提卡接口（or
18、der.do）此接口依据用户的请求返回卡号密码信息：请求参数： 说明userid SP 编码如（A00001）在登陆系统时得到以 A 开头的编号userpws SP 接入密码( 为账户密码的 MD5 值，如登陆密码为 111111,此时这个值为md5(“111111”) (32 位小写)cardid 所需提货商品的编码(需和 CP 商品编码一一对应)cardnum 所需提货商品的数量（1-10 张） ,cardnum 不穿默认为 1sporder_id Sp 商家的订单号sporder_time 订单时间 （yyyyMMddHHmmss 如：20070323140214）md5_str Md5
19、 验证字符串， phone 收货手机号（可为空，不参与 MD5 验证）email 收货邮箱地址（可为空，不参与 MD5 验证）version 固定值为：6.0 (不参与 MD5 验证)说明：md5_str 检验码的计算方法: 包体=userid+userpws+cardid+cardnum+sporder_id+sporder_time1: 对: “包体+KeyStr” 这个串进行 md5 的 32 位值. 结果大写2: KeyStr 默认为 OFCARD, 实际上线时可以修改。3: KeyStr 不在接口间进行传送。4:cardnum 参与 md5 验证,cardnum 不传或为空时，car
20、dnum 默认为 1。响应的 XML 标签说明 说明err_msg 错误描述，如请求得到正确返回，此处将为空retcode 操作返回代码，1 成功,err_msg 为空，其它数字具体错误在 err_msg 返回Orderinfo CP 返回的订单信息调用的链接如下：http:/ =xxxxxxxxxxxxx&version=6.0返回的内容：- 欧飞SP合作接口文档机密 第 10 页 共 47 页1S0703280004 /CP 流水号360101 /卡编码 1 /购买卡数量1 /订单金额(元)欧飞 1 分钱支付体验卡 /卡名称 123 /SP 订单号- - you /卡号success /密
21、码 4000-12-31 /有效期9 游戏直充区服查询接口（getareaserver.do）此接口用于查询游戏直充的区服信息：请求 URL 为：http:/ gameid 为游戏编号，可以为空，为空时查询全部。返回的内容：229517 /商品编号（对应 cardid）御龙在天 389w 双线一区 /游戏区（对应 game_area）2w 龙啸九天 /游戏服（对应 game_srv）229517.1 以上参数如果是中文，需将参数值 URL 编码传递（GBK）欧飞SP合作接口文档机密 第 11 页 共 47 页10 游戏直充接口（onlineorder.do）此接口依据用户提供的请求为指定游戏玩
22、家直接充值(包括 Q 币充值)请求参数： 说明userid SP 编码如（A00001）在登陆系统时得到以 A 开头的编号userpws SP 接入密码( 为账户密码的 MD5 值，如登陆密码为 111111,此时这个值为md5(“111111”) (32 位小写)cardid 所需提货商品的编码(需和 CP 商品编码一一对应,需 22 开头的编码)cardnum 所需提货商品的数量（1-10 张）sporder_id Sp 商家的订单号sporder_time 订单时间 （yyyyMMddHHmmss 如：20070323140214）game_userid 游戏玩家账号(game_user
23、id=$xxx001 是通行证xxx001 是玩家账号)game_userpsw 游戏玩家的密码（可以为空，并且不参与 MD5 验算）game_area 游戏所在区域（没有则不填,需按 CP 要求填写）game_srv 游戏所在服务器组（没有则不填,需按 CP 要求填写）md5_str MD5 后字符串ret_url 订单充值成功后返回的 URL 地址，可为空（不参与 MD5 验算）请使用80 端口 version 固定值为：6.0 (不参与 MD5 验证)userip买家 IP(不参与 MD5 验证，当此参数有值时，此值作为订单来源 IP 存入库)响应的 XML 标签说明 说明err_ms
24、g 错误描述，如请求得到正确返回，此处将为空retcode 操作返回代码，1 成功,err_msg 为空，其它数字具体错误在 err_msg 返回orderinfo CP 返回的订单信息md5_str 检验码的计算方法:包体=userid+userpws+cardid+cardnum+sporder_id+sporder_time+ game_userid+ game_area+ game_srv1: 对: “包体+KeyStr” 这个串进行 md5 的 32 位值. 结果大写2: KeyStr 默认为 OFCARD, 实际上线时可以修改。3: KeyStr 不在接口间进行传送。调用的链接如下
25、：http:/ URL 编码传递（GBK）ret_url 不为空时，系统将在充值成功时，发送成功信息到 ret_url 地址：例：ret_url =http:/ SP 商户提供系统请求参数：ret_code 充值后状态， 1 代表成功，9 代表撤消欧飞SP合作接口文档机密 第 12 页 共 47 页sporder_id SP 订单号ordersuccesstime 处理时间(yyyyMMddHHmmss)err_msg 失败原因提交方式为：POST注：SP 得到请求信息后，请自行处理系统订单状态。如 SP 系统问题没收到返回结果，或者在长时间内没有收到充值成功信息，可再次发送此笔订单到查询接口
26、查看充值状态（SP 订单号为原订单号），如还是没有充值成功请和 CP 客服联系，以做进一步处理。返回的内容：- 1S0703300003 221201 1 1剑侠情缘 II15 元直充 2443 ybb 三区 天下一家 0 /如果成功将为 1，澈消(充值失败) 为 9，充值中为 0,只能当状态为 9 时，商户才可以退款给用户。11 手机号码归属地查询（mobinfo.do）此接口用于查询手机号码的归属地：请求参数： 说明mobilenum 手机号码前七位例：http:/ 江苏南京| 移动全球通卡12 查询手机号当时是否可以充值（telcheck.do）http:/ 第 13 页 共 47 页r
27、id=Axxxxxprice 为充值面值、userid 为会员编号返回：1#成功#0000&江苏南京1 表示能充值，其它表示不能充。13 根据手机号和面值查询商品信息（telquery.do）此接口用于查询手机号是否能充值，如果能充值返回商品信息，不能充返回运营商维护请求参数： 说明userid SP 编码如（A00001）在登陆系统时得到以 A 开头的编号userpws SP 接入密码( 为账户密码的 MD5 值，如登陆密码为 111111,此时这个值为md5(“111111”) (32 位小写)phoneno 手机号pervalue 快充可选面值（1、2、5、10、20、30、50、100
28、、300）慢充可选面值（30、50、100）mctype（慢充才传） 慢充类型：0.5（半小时到账）、4（4 小时到账）、12（12 小时到账）、24（24 小时到账）、48（48 小时到账）、72（72 小时到账）cardtype 商品类型：17 （慢充）、23 （流量包）version 固定值为：6.0 (不参与 MD5 验证)请求 URL 为：http:/ 1 141403 江苏移动充值 50 元50 江苏南京移动 欧飞SP合作接口文档机密 第 14 页 共 47 页运营商地区维护，暂不能充值 11 14 手机直充接口（onlineorder.do）此接口依据用户提供的请求为指定手机直接
29、充值，这个接口和游戏直充使用同一个接口：请求参数： 说明userid SP 编码如（A00001）在登陆系统时得到以 A 开头的编号userpws SP 接入密码( 为账户密码的 MD5 值，如登陆密码为 111111,此时这个值为md5(“111111”) (32 位小写)cardid所需提货商品的编码(快充：140101，慢充：170101 ，流量充值：230101 )这里商品编码是模糊匹配只匹配前两位cardnum 快充可选面值（1、2、5、10、20、30、50、100、200、300、500）慢充可选面值（30、50、100）mctype慢充类型：0.5（半小时到账）、4（4 小时到
30、账）、12（12 小时到账）、24（24 小时到账）、48（48 小时到账）、72（72 小时到账）（不传默认为 24，不参与 MD5 验证）sporder_id Sp 商家的订单号sporder_time 订单时间 （yyyyMMddHHmmss 如：20070323140214）game_userid 手机号md5_str MD5 后字符串ret_url 订单充值成功后返回的 URL 地址，可为空（不参与 MD5 验算）version 固定值为：6.0 (不参与 MD5 验证)md5_str 检验码的计算方法:包体=userid+userpws+cardid+cardnum+sporder
31、_id+sporder_time+ game_userid1: 对: “包体+KeyStr” 这个串进行 md5 的 32 位值. 结果大写2: KeyStr 默认为 OFCARD, 实际上线时可以修改。3: KeyStr 不在接口间进行传送。调用的链接如下：http:/ URL 编码传递（GBK）ret_url 不为空时，系统将在充值成功时，发送成功信息到 ret_url 地址：例：ret_url =http:/ SP 商户提供系统请求参数：ret_code 充值后状态， 1 代表成功，9 代表撤消sporder_id SP 订单号欧飞SP合作接口文档机密 第 15 页 共 47 页orde
32、rsuccesstime 处理时间err_msg 失败原因(ret_code 为 1 时，该值为空)提交方式为：POST注：SP 得到请求信息后，请自行处理系统订单状态。如 SP 系统问题没收到返回结果，或者在长时间内没有收到充值成功信息，可再次发送此笔订单到查询接口查看充值状态（SP 订单号为原订单号），如还是没有充值成功请和 CP 客服联系，以做进一步处理。返回的内容：- 1S0703300003 142303 1 99.8江苏移动 100 元充值 200912180001 13813834333 0 /如果成功将为 1，澈消(充值失败) 为 9，充值中为 0,只能当状态为 9 时，商户才
33、可以退款给用户。15 根据固话/宽带号码和面值查询商品信息（fixtelquery.do）此接口用于查询固话是否能充值，如果能充值返回商品信息，不能充返回运营商维护请求参数： 说明userid SP 编码如（A00001）在登陆系统时得到以 A 开头的编号userpws SP 接入密码( 为账户密码的 MD5 值，如登陆密码为 111111,此时这个值为md5(“111111”) (32 位小写)teltype 运营商 1、电信 2、联通（不传默认为 1）phoneno 固话号码 （格式：021-88888888 ）pervalue 面值 （电信：10、20、30、50、100、300，联通：
34、50、100）version 固定值为：6.0 (不参与 MD5 验证)chargeType 充值类型 （可选：1：固话；2：宽带；默认为固话）请求 URL 为：http:/ 第 16 页 共 47 页返回的内容：成功 1 191103 上海电信 CDMA 固话充值 50 元49.4 上海上海电信 运营商地区维护，暂不能充值 11 16 固话/宽带直充接口（fixtelorder.do ）此接口依据用户提供的请求为指定固话直接充值：请求参数： 说明userid SP 编码如（A00001）在登陆系统时得到以 A 开头的编号userpws SP 接入密码( 为账户密码的 MD5 值，如登陆密码为
35、 111111,此时这个值为md5(“111111”) (32 位小写)cardnum 购买面值（电信：10、20、30、50、100、300，联通：50、100）teltype 运营商 1、电信 2、联通（不传默认为 1，不参与 MD5 验证）chargeType 充值类型 （可选：1：固话；2：宽带；默认为固话）sporder_id Sp 商家的订单号sporder_time 订单时间 （yyyyMMddHHmmss 如：20070323140214）game_userid 固话号码 （格式：021-88888888 ），宽带号码为区号后 3 到 10 位数字或者字母(备注：暂不支持含字母
36、的宽带账号 )md5_str MD5 后字符串ret_url 订单充值成功后返回的 URL 地址，可为空（不参与 MD5 验算）version 固定值为：6.0 (不参与 MD5 验证)md5_str 检验码的计算方法:包体=userid+userpws+cardnum+sporder_id+sporder_time+ game_userid1: 对: “包体+KeyStr” 这个串进行 md5 的 32 位值. 结果大写2: KeyStr 默认为 OFCARD, 实际上线时可以修改。3: KeyStr 不在接口间进行传送。调用的链接如下：http:/ 第 17 页 共 47 页xxxxxxx
37、x&sporder_time=xxxxxxxx&game_userid=xxxxx&md5_str=xxxxxxxxxxxxx&ret_url=xxxxx&version=6.0以上参数如果是中文，需将参数值 URL 编码传递ret_url 不为空时，系统将在充值成功时，发送成功信息到 ret_url 地址：例：ret_url =http:/ SP 商户提供系统请求参数：ret_code 充值后状态， 1 代表成功，9 代表撤消sporder_id SP 订单号ordersuccesstime 处理时间err_msg 失败原因(ret_code 为 1 时，该值为空)提交方式为：POST注：S
38、P 得到请求信息后，请自行处理系统订单状态。如 SP 系统问题没收到返回结果，或者在长时间内没有收到充值成功信息，可再次发送此笔订单到查询接口查看充值状态（SP 订单号为原订单号），如还是没有充值成功请和 CP 客服联系，以做进一步处理。返回的内容：- 1S0703300003 191103 1 49.4上海电信 CDMA 固话充值 50 元 200912180001 021-12345678 0 /如果成功将为 1，澈消(充值失败) 为 9，充值中为 0,只能当状态为 9 时，商户才可以退款给用户。17 根据 SP 订单号查询充值状态(api/query.do)此接口用于查询订单的充值状态：
39、请求参数： 说明userid SP 编码如（A00001）spbillid Sp000001,商户系统订单号调用的链接如下：http:/ 1 充值成功，0 充值中，9 充值失败，-1 找不到此订单。如果返回-1，请您务必进入平台或者联系欧飞客服进行核实，避免给自己带来不必要的损失。欧飞SP合作接口文档机密 第 18 页 共 47 页18 自动对账接口（querybill.do） 此接口给 SP 进行交易记录查询以帮助 SP 实现自动对帐（三天之内）：请求参数： 说明userid SP 编码如（A00001）在登陆系统时得到以 A 开头的编号userpws SP 接入密码( 为账户密码的 MD5
40、 值，如登陆密码为 111111,此时这个值为md5(“111111”) (32 位小写)cardid 所需提货商品的编码（支持 2 位，4 位和 6 位），不填为全部starttime 开始时间 （yyyyMMdd 如：20070323）endtime 结束时间 （yyyyMMdd 如：20070323）md5_str 验证字符串 (32 位大写)version 固定值为：6.0 (不参与 MD5 验证)Md5_str=md5(userid+userpws+cardid+starttime+endtime+key)调用的链接如下：http:/ =xxxxxxxxx&endtime=xxxxx
41、xxx&md5_str=xxxxxxxxxxxxx&version=6.0返回的内容：CP 流水号|SP 订单号|商品编号|商品数量| 充值账号|订单金额|订单时间| 订单状态S0704020968|1|360101|1|0.01|2007-04-02 17:56:10|1S0703230929|2|360101|1|0.01|2007-03-23 16:56:07|1S0703230888|3|360101|1|0.01|2007-03-23 16:40:54|1S0703230777|4|360101|1|0.01|2007-03-23 15:51:57|1订单总数:932|订单总额:12
42、3123.22219 根据 SP 订单号补发充值状态(只补发最近三天内订单)（reissue.do）此接口用于没有接收到回调充值状态的情况下进行补发：请求参数： 说明userid SP 编码如（A00001）在登陆系统时得到以 A 开头的编号userpws SP 接入密码( 为账户密码的 MD5 值，如登陆密码为 111111,此时这个值为md5(“111111”) (32 位小写)spbillid Sp000001,商户系统订单号version 固定值为：6.0 (不参与 MD5 验证)请求 URL 为：http:/ 第 19 页 共 47 页返回的内容：补发成功1 20 身份证核查接口（i
43、dcardquery.do ）（此接口停用 ）请求参数： 说明userid SP 编码如（A00001）在登陆系统时得到以 A 开头的编号userpws SP 接入密码( 为账户密码的 MD5 值，如登陆密码为 111111,此时这个值为md5(“111111”) (32 位小写)sporder_id Sp 商家的订单号sporder_time 订单时间 （yyyyMMddHHmmss 如：20070323140214）idcard 身份证号码name 姓名md5_str MD5 后字符串version 固定值为：6.0 (不参与 MD5 验证)md5_str 检验码的计算方法:包体=userid+userpws+sporder_id+sporder_time+idcard+name1:
