文档介绍：文档编号:
密级:
第三方统一接口说明书
浙江连连科技有限公司
2009年 8月
文档修改记录
版本号
修订日期
修订说明
编写者
审核者
2009-8-15
初稿
张勇钢
2009-8-20
完善数据交互模式等说明
接入功能接口表直接嵌入文档
张勇钢
说明
本文档中所包含的信息属于商业机密信息,如无浙江连连科技有限公司的书面许可,任何人都无权复制或利用。
目录
1 概述 1
编写说明 1
预期读者 1
2 接口实现 2
总体协议 2
基础封包 2
安全封包 2
XRPC报文体 3
总体节点结构 3
文件传输 4
应答处理 5
数据传输约定 5
数据字典 5
业务接口常用要素节点说明 5
数据交互模式 5
同步交易 5
异步交易 6
主动通知 7
重播控制 8
安全访问控制 8
交易账务类型 9
变更类 9
查询类 9
辅助类 9
接入功能接口 9
即时下单类交易OT02** 9
同步下单交易OT0201 9
同步下单交易结果查询OT0202 10
撤单交易OT0204 10
异步下单交易OT0211 10
异步下单结果查询OT0212 11
异步下单通知OT0213 11
订单类交易OT03** 11
订单创建交易OT0301 11
订单撤销交易OT0302 11
订单支付交易OT0303 11
订单查询交易OT0304 12
账户管理类交易OT08** 12
商户资金余额查询OT0801 12
商户资金转账交易OT0802 12
账务管理类OT09** 12
当期总账查询OT0908 12
明细文件下载OT0909 13
系统支撑交易OT99** 13
商户签到OT9901 13
商户签退OT9902 13
商户密钥同步OT9903 13
商户许可商品清单获取OT9909 13
接出功能接口 14
即时下单类交易接口 14
支付交易接口 14
3 附录 15
XRPC数据报文范例 15
请求报文 15
应答报文 15
响应信息表 15
数据字典 17
省份代码表 17
常见问题与处理 17
开发问题 17
运行问题 18
概述
编写说明
连连电子支付系统和各类合作商户系统进行了互联,合作商户系统包括业务供应合作商户即接出方和业务渠道合作商户即接入方。合作商户的业务类型是复杂多样的,本接口提供了统一的合作商户接入接出接口,通过一套接口,实现对各种业务的统一接入。
本文档用于指导连连合作商户系统软件开发人员,实现与连连系统的交易互联。
接口从方向上而言,包括了两类,即接入接口和接出接口。
预期读者
合作商户系统软件开发人员;
连连平台开发人员及审核者。
接口实现
总体协议
本接口通过XRPC接口和外部商户实现交易互联,所谓的XRPC接口,是以XML格式为数据主体组织形式的远程功能调用接口。
接口以socket服务为合作商户提供服务。
合作商户系统应使用静态IP的服务器作为发起方向本接口所在服务器请求服务,并将发起服务器地址提供给连连以便进行IP访问限定。
基础封包
4字节网络字节序报文体长度+报文体
安全封包
接口提供了不同强弱程度的安全模式:
方式一:明文
报文体即明文报文,此种方式通常在交易测试联调阶段使用,生产环境不采用。
方式二:MD5校验
采用MD5算法,对明文报文体进行MD5运算获得校验字段用于验算匹配
。
方式三:MD5签名
采用MD5算法,对(MD5_KEY+明文报文体)的组合信息(+表示连接,实际不存在,不参与MD5运算),进行MD5运算获得校验字段用于验算匹配,MD5_KEY由双方约定。
方式四: