连连电子支付平台 第三方统一接口设计说明书.docVIP

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