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

文档编号： 密 级：  第三方统一接口说明书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** 1.0 同步下单交易OT0201 同步下单交易结果查询OT0202 撤单交易OT0204 异步下单交易OT0211 异步下单结果查询OT0212 异步下单通知OT0213 2.2.2 订单类交易OT03** 1.2 订单创建交易OT0301 订单撤销交易OT0302 订单支付交易OT0303 订单查询交易OT0304 2.2.3 账户管理类交易OT08** 1.2 商户资金余额查询OT0801 商户资金转账交易OT0802 2.2.4 账务管理类OT09** 1.3 当期总账查询OT0908 明细文件下载OT0909 2.2.5 系统支撑交易OT99** 1.3 商户签到OT9901 商户签退OT9902 商户密钥同步OT9903 商户许可商品清单获取OT9909 2.3 接出功能接口1.4 2.3.1 即时下单类交易接口1.4 2.3.2 支付交易接口1.4 3 附录1.5 3.1 XRPC 数据报文范例1.5 3.1.1 请求报文1.5 3.1.2 应答报文1.5 3.2 响应信息表1.5 3.3 数据字典1.7 3.3.1 省份代码表1.7 3.4 常见问题与处理 1.8 3.4.1 开发问题1.8 3.4.2 运行问题1.8 第三方统一接口 第三方统一接口 22第 1 22 第 1 页 共 页 概述 编写说明 连连电子支付系统和各类合作商户系统进行了互联，合作商户系统包括业务供应合 作商户即接出方和业务渠道合作商户即接入方。合作商户的业务类型是复杂多样的，本 接口提供了统一的合作商户接入接出接口，通过一套接口，实现对各种业务的统一接入。 本文档用于指导连连合作商户系统软件开发人员，实现与连连系统的交易互联。接口从方向上而言，包括了两类，即接入接口和接出接口。 预期读者 合作商户系统软件开发人员； 连连平台开发人员及审核者。 第三方统一接口 第三方统一接口 32字节MD5码MD5校验MD5签名明文数据报文体RSA加密加密数据报文体接口提供了不同强弱程度的安全模式：?方式一：明文报文体即明文报文，此种方式通常在交易测试联调阶段使用，生产环境不采用。 32字节MD5码 MD5校验MD5签名 明文数据报文体 RSA加密 加密数据报文体 接口提供了不同强弱程度的安全模式： ? 方式一：明文 报文体即明文报文，此种方式通常在交易测试联调阶段使用，生产环境不采用。方式二：MD5 校验 采用 MD5 算法，对明文报文体进行MD5 运算获得校验字段用于验算匹配。 ? 22 第 2 页 共 页 接口实现 总体协议 本接口通过XRPC 接口和外部商户实现交易互联，所谓的XRPC 接口，是以XML 格式为数据主体组织形式的远程功能调用接口。 接口以socket 服务为合作商户提供服务。 合作商户系统应使用静态 IP 的服务器作为发起方向本接口所在服务器请求服务， 并将发起服务器地址提供给连连以便进行IP 访问限定。 基础封包 4 字节网络字节序报文体长度+报文体 网络字节序 网络字节序 4字节报文体长度 报文体 安全封包 明文传输明文数据报文体 明文传输 明文数据报文体 第三方统一接口 第三方统一接口 22第 PAGE 22 第 PAGE 10 页 共 页 方式三：MD5 签名 采用 MD5 算法，对（MD5_KEY+明文报文体）的组合信息（+表示连接，实际不存在，不参与 MD5 运算），进行 MD5 运算获得校验字段用于验算匹配， MD5_KEY 由双方约定。 方式四：RSA 加密