交通银行API报文交换规范-v11.doc

JAVA Socket Bridge API 报文交换规范 版本 1.0 2012年03月 目 录 1 报文交换标准概述 6 1.1 术语说明 6 1.2 业务标准 6 1.2.1 字符集和编码 6 2 报文格式概述 7 2.1 报文结构 7 2.2 数据类型 7 2.2.1 报文约束 8 2.2.2 请求报文格式说明 8 2.2.3 响应报文格式说明 8 2.3 报文格式 8 2.3.1 请求报文样式 8 2.3.2 响应报文样式 9 2.4 数字签名 10 2.4.1 加签要素和数字签名编制 10 2.4.2 报文的数字签名核验标准 10 3 报文通讯方式 10 3.1 普通商户API生产环境商户接入地址 10 3.2 普通商户API测试环境商户接入地址 11 3.3 一键支付API生产环境商户接入地址 11 3.4 一键支付API测试环境商户接入地址 11 4 报文清单及概要 11 4.1 普通商户API报文清单 11 4.2 一键支付API报文清单 11 5 API交易报文 12 5.1 报文字段 12 5.1.1 订单提交 12 5.1.2 提交预订单 13 5.1.3 商户结算账户余额查询 14 5.1.4 批量订单查询 14 5.1.5 当批订单查询 14 5.1.6 历史订单查询 14 5.1.7 退款明细查询 15 5.1.8 退款录入 15 5.1.9 直接退款 16 5.1.10 结算明细下载 16 5.1.11 持卡人身份验证（VIP商户） 16 5.2 交易接口返回XML包 17 5.2.1 结算账户余额查询 17 5.2.2 批量订单查询 17 5.2.3 当批订单查询 18 5.2.4 历史订单查询查询 19 5.2.5 退款明细查询 20 5.2.6 退款录入 21 5.2.7 对帐单下载 21 5.2.8 持卡人身份验证（VIP商户使用） 22 5.2.9 当批订单完整查询 22 5.3 API联机交易签名与验签 23 6 一键支付API交易报文 23 6.1 一键支付跳转签约 23 6.1.1 报文功能 23 6.1.2 请求报文结构 23 6.1.3 响应报文结构 24 6.1.4 报文说明 25 6.2 一键支付协议查询 25 6.2.1 报文功能 25 6.2.2 请求报文结构 26 6.2.3 响应报文结构 26 6.2.4 报文说明 26 6.3 一键支付协议撤销 26 6.3.1 报文功能 26 6.3.2 请求报文结构 26 6.3.3 响应报文结构 27 6.3.4 报文说明 27 6.4 发送客户验证短信 27 6.4.1 报文功能 27 6.4.2 请求报文结构 27 6.4.3 响应报文结构 28 6.4.4 报文说明 28 6.5 重发客户验证短信 28 6.5.1 报文功能 28 6.5.2 请求报文结构 28 6.5.3 响应报文结构 28 6.5.4 报文说明 29 6.6 短信版支付 29 6.6.1 报文功能 29 6.6.2 请求报文结构 29 6.6.3 响应报文结构 30 6.6.4 报文说明 31 6.7 直付版支付 31 6.7.1 报文功能 31 6.7.2 请求报文结构 32 6.7.3 响应报文结构 33 6.7.4 报文说明 34 7 API客户端使用说明 34 7.1 商户证书安装 34 7.1.1 银行申请 34 7.1.2 商户证书下载 34 7.1.3 商户证书更新 39 7.1.4 证书相关安放与配置 – Java环境 40 7.2 客户端配置 40 文档信息及修订记录 修 订 人 修订说明 版本号 邹鹏 座机电话号码 文档初建 报文交换标准概述 报文交换标准均采用XML格式描述。根据，进行了必要的格式约束。术语说明 业务要素 业务要素是业务数据项的抽象名称，是业务的基本组成单位，如的。 报文 报文是系统节点间交换业务数据的基本单位，由报文头和报文体组成，其中报文体由多个报文块组成。 报文块 报文块是报文的基本组成单位，使用XML标签界定，由多个报文域组成。 报文域 报文域是报文块的基本组成单位，使用XML标签界定。每个报文域封装一个或多个业务要素，多个报文域组成报文块。对复杂的业务要素，报文域可能包含多个报文子域。 根报文域 报文使用XML文档标准，该文档的根节点称为根报文域，标签固定为 。 报文子域 对于分级的报文域，较低级的域称作报文子域，使用XML标签界定，位于较高级报文域的XML标签内部。 业务标准 字符集和编码 报文采用Unicode字符集，编码方式。报文格式概述 报文结构系统使用XML报文传输业务数据。：（）MsgContent 子报文 数据类型 序号 类型名称 类型定义 附加说明 MaxNT