1、 商户 API 报文交换规范1 / 41JAVA Socket Bridge API报文交换规范版本 1.02012 年 03 月商户 API 报文交换规范2 / 41目 录1 报文交换标准概述 .61.1 术语说明 61.2 业务标准 61.2.1 字符集和编码 62 报文格式概述 .72.1 报文结构 72.2 数据类型 72.2.1 报文约束 82.2.2 请求报文格式说明 82.2.3 响应报文格式说明 82.3 报文格式 82.3.1 请求报文样式 82.3.2 响应报文样式 92.4 数字签名 102.4.1 加签要素和数字签名编制 102.4.2 报文的数字签名核验标准 103
2、报文通讯方式 .103.1 普通商户 API 生产环境商户接入地址 .103.2 普通商户 API 测试环境商户接入地址 .113.3 一键支付 API 生产环境商户接入地址 .113.4 一键支付 API 测试环境商户接入地址 .114 报文清单及概要 .114.1 普通商户 API 报文清单 .114.2 一键支付 API 报文清单 .115 API 交易报文 .125.1 报文字段 125.1.1 订单提交 125.1.2 提交预订单 135.1.3 商户结算账户余额查询 145.1.4 批量订单查询 145.1.5 当批订单查询 145.1.6 历史订单查询 145.1.7 退款明细查
3、询 155.1.8 退款录入 155.1.9 直接退款 165.1.10 结算明细下载 165.1.11 持卡人身份验证（VIP 商户） 165.2 交易接口返回 XML 包 .17商户 API 报文交换规范3 / 415.2.1 结算账户余额查询 175.2.2 批量订单查询 175.2.3 当批订单查询 185.2.4 历史订单查询查询 195.2.5 退款明细查询 205.2.6 退款录入 215.2.7 对帐单下载 215.2.8 持卡人身份验证（VIP 商户使用） 225.2.9 当批订单完整查询 225.3 API 联机交易签名与验签 236 一键支付 API 交易报文 236.1
4、 一键支付跳转签约 236.1.1 报文功能 236.1.2 请求报文结构 236.1.3 响应报文结构 246.1.4 报文说明 256.2 一键支付协议查询 256.2.1 报文功能 256.2.2 请求报文结构 266.2.3 响应报文结构 266.2.4 报文说明 266.3 一键支付协议撤销 266.3.1 报文功能 266.3.2 请求报文结构 266.3.3 响应报文结构 276.3.4 报文说明 276.4 发送客户验证短信 276.4.1 报文功能 276.4.2 请求报文结构 276.4.3 响应报文结构 286.4.4 报文说明 286.5 重发客户验证短信 286.5.
5、1 报文功能 286.5.2 请求报文结构 286.5.3 响应报文结构 286.5.4 报文说明 296.6 短信版支付 296.6.1 报文功能 296.6.2 请求报文结构 296.6.3 响应报文结构 306.6.4 报文说明 316.7 直付版支付 316.7.1 报文功能 316.7.2 请求报文结构 32商户 API 报文交换规范4 / 416.7.3 响应报文结构 336.7.4 报文说明 347 API 客户端使用说明 .347.1 商户证书安装 347.1.1 银行申请 347.1.2 商户证书下载 347.1.3 商户证书更新 397.1.4 证书相关安放与配置 Java
6、 环境 .407.2 客户端配置 40商户 API 报文交换规范5 / 41文档信息及修订记录修 订 人 修订日期 修订说明 版本号邹鹏 20120314 文档初建 1.0商户 API 报文交换规范6 / 411 报文交换标准概述一键支付报文交换标准均采用 XML 格式描述。并且根据业务接口定义，进行了必要的格式约束。1.1 术语说明1. 业务要素业务要素是业务数据项的抽象名称，是业务的基本组成单位，如订单的商户号。2. 报文报文是系统节点间交换业务数据的基本单位，由报文头和报文体组成，其中报文体由多个报文块组成。3. 报文块报文块是报文的基本组成单位，使用 XML 标签界定，由多个报文域组成
7、。4. 报文域报文域是报文块的基本组成单位，使用 XML 标签界定。每个报文域封装一个或多个业务要素，多个报文域组成报文块。对复杂的业务要素，报文域可能包含多个报文子域。5. 根报文域报文使用 XML 文档标准，该文档的根节点称为根报文域，标签固定为。6. 报文子域对于分级的报文域，较低级的域称作报文子域，使用 XML 标签界定，位于较高级报文域的 XML 标签内部。1.2业务标准1.2.1 字符集和编码报文采用 Unicode 字符集，GBK 编码方式。商户 API 报文交换规范7 / 412 报文格式概述2.1 报文结构系统使用 XML 报文传输业务数据。报文分为主体报文和子报文，主题报文
8、为商户客户系统和 socket bridge 通讯的报文，子报文为 socket bridge 和银行端通讯的报文，子报文嵌入在主报文里：Message（主报文）MsgContent(子报文)2.2 数据类型序号 类型名称 类型定义 附加说明1. MaxNText 表示字符串，最少 1 位，最多 N 位的文本。 1 位表示 1 个字母、数字字符，或 1个汉字。2. MaxNNumericText 表示数字串，最少 1 位，最多 N 位的数字。3. Date 表示日期，格式为 yyyymmdd 例如：201005014. Time 表示时间，格式为 HHMMSS 例如：1509055. Date
9、Time 表示日期和时间，格式为yyyymmddHHMMSS 例如：201005011509056. Currency 表示货币符号 目前只支持人民币，人民币的货币符号为“CNY”7. Amount 表示金额，金额最多 15 位数字，其中小数部分为 2 位数字。例如：2784245.00在本系统中，整数部分最多 13 位，小数部分强制保留 2 位数字（例如一元只能为 1.00，不能为 1 或者1.0） ，金额第一位非零数字前禁止补零（例如一元只能为 1.00，不能为 01.00 或者前补更多 0） 。 8. SignedAmount表示带符号位的金额，金额最多18 位数字，其中小数部分为 2
10、位数字。标识相应栏位是带符号位的金额，负数的符号位为负号(-)，0 或正数不带符号位。例如： -1234.56，而+1234.56为非法的表示方式。在本系统中，整数部分最多 13 位，小数部分强制保留 2 位数字（例如一元只能为 1.00，不能为 1 或者1.0） ，金额第一位非零数字前禁止商户 API 报文交换规范8 / 41补零（例如一元只能为 1.00，不能为 01.00 或者前补更多 0） 。2.2.1 报文约束报文定义中“属性”字段格式为xy，其中 x 表示该字段最少出现次数，y 表示该字段最多出现次数；例如110表示该字段最少出现 1 次，最多出现 10 次。2.2.2 请求报文格
11、式说明主体报文:序号 报文要素 属性 类型 备注1. 交易码 11 Max8Text2. 配置文件路径 11 Max100Text 网上支付不用不配置3.交易标签11 Max1Text 0：网上支付1：一键支付不配置则为网上支付4. 子报文 11 Max100Text请求报文没有报文头，所以请求报文格式主要参照具体交易报文定义。2.2.3 响应报文格式说明序号 报文要素 属性 类型 备注5. 交易返回码 11 Max8Text6. 交易返回信息 01 Max100Text2.3 报文格式报文体为 XML 格式，使用标签标识 XML 报文的根， 作为报文体的标签。2.3.1 请求报文样式cb00
12、00_demoOpc:bocommjavainiB2CMerchant.xml商户 API 报文交换规范9 / 411cb0000_demoOp301310063009501000120101010201010110012.3.2 响应报文样式000000交易成功30131006300950110BOC1000000000005872012011511253203101商户 API 报文交换规范10 / 412.4 数字签名2.4.1 加签要素和数字签名编制系统使用数字签名保证业务数据的可靠性和防抵赖性。数字签名由业务发起方编制，业务接收方核验。编制业务数字签名的做法如下：（1）按报文中业务要
13、素出现的顺序组织最终 XML 报文。（2）使用本行的数字证书（私钥）对签名要素串签名，签名的校验算法使用SHA1WithRSA 算法；（3）使用本行提供的签名组件中的 AttachedSign 方式，并使用本行的数字证书中的私钥对 XML 报文进行签名，AttachedSign 方式同时将原始报文与签名数据编码在一起，最终产生 byte 数据并进行 Base64 编码；（4）将步骤（3 ）的输出数据，将数据中的回车符 (rn)全部去处后，将最终数据作为表单数据发送至对方，数据项名称为 reqData；以上过程由 API 包完成，无需商户实现。2.4.2 报文的数字签名核验标准报文的接受方在接受
14、发送方以 HTTP 方式提交的数据 xml 后：（1）先使用签名组件中的 AttachedVerify 方法进行数字签名验签，验证时会使用本行的根证书，根证书将会保证签名的数据是由本行所签发的商户证书所产生的签名；（2）然后提取发送方的公钥证书，并且验证公钥的合法性，提取证书的 DN 域，验证该域是否与发送方的商户号一致；（3）并且验证公钥证书的有效期；3 报文通讯方式系统采用 HTTP 协议进行通讯，对所有数据进行 SSL 加密后传输；编码签名后的数据xml 采用 HTTP POST 方式提交至对方系统；3.1 普通商户 API 生产环境商户接入地址https:/ API 报文交换规范11
15、/ 413.2 普通商户 API 测试环境商户接入地址https:/ 一键支付 API 生产环境商户接入地址https:/ 一键支付 API 测试环境商户接入地址https:/ 报文清单及概要4.1 普通商户 API 报文清单序号 报文名称 交易号 报文格式 是否加签1. 订单提交 cb2200_sign xml 2. 提交预订单 cb2210_create_orderOp xml 3. 商户结算账户余额查询cb2201_AccountBalanceOp xml 4. 批量订单查询 cb2202_queryOrderOp.xml xml 5. 当批订单查询 cb2203_queryCurOrd
16、erOp.xml xml 6. 历史订单查询 cb2204_queryHistoryOrderOp.xml xml 7. 退款明细查询 cb2205_queryRefundOp.xml xml 8. 退款录入 cb2206_RefundOp.xml xml 9. 直接退款 cb2212_DirectRefundOp xml 10. 结算明细下载 cb2207_downLoadSettlementOp.xml xml 11. 持卡人身份验证（VIP 商户） cb2208_verifyCustIDOp.xmlxml 4.2 一键支付 API 报文清单序号 报文名称 报文方向 报文格式 是否加签1
17、一键支付跳转签约 商户-我行网上支付商户我行网上支付 xml 商户 API 报文交换规范12 / 413 一键支付协议撤销 商户-我行网上支付 xml 4 发送客户验证短信 商户-我行网上支付 xml 5 重发客户验证短信 商户-我行网上支付 xml 6 短信版支付 商户-我行网上支付 xml 7 直付版支付 商户-我行网上支付 xml 5 API 交易报文5.1 报文字段每一个请求报文里都存在 TranCode 来标示交易号。5.1.1 订单提交请求报文：字段中文名 字段名 类型和长度 必输 备注1. 消息版本号 interfaceVersion Y2. 订单号 orderid Y3. 商户
18、订单日期orderDate Y yyyyMMdd4. 商户订单时间orderTime Y HHmmss5. 交易类别 tranType Y 0:B2C6. 订单金额 Amount Y7. 交易币种 curType Y8. 订单内容 orderContent9. 商家备注 orderMono10. 物流配送标志phdFlag11. 通知方式 notifyType Y 0 不通知 1 通知12. 主动通知URLmerURL13. 取货 URL goodsURL14. 自动跳转时间jumpSeconds15. 商户批次号 payBatchNo 商家对账使用商户 API 报文交换规范13 / 4116
19、. 代理商家名称proxyMerName17. 代理商家类型proxyMerType18. 代理商家证件号码proxyMercredentials19. 渠道编号 netType Y 0:html 渠道（默认 0）20. 发卡行机构号 issBankNo 不输默认为交行(规则同银联)5.1.2 提交预订单请求报文：字段中文名 字段名 类型和长度 必输 备注1. 消息版本号 interfaceVersion Y2. 订单号 orderid Y3. 商户订单日期 orderDate Y yyyyMMdd4. 商户订单时间 orderTime Y HHmmss5. 交易类别 tranType Y 0
20、:B2C6. 订单金额 Amount Y7. 交易币种 curType Y8. 订单内容 orderContent9. 商家备注 orderMono10. 物流配送标志 phdFlag11. 通知方式 notifyType Y 0 不通知 1 通知12. 主动通知URLmerURL13. 取货 URL goodsURL14. 自动跳转时间 jumpSeconds15. 商户批次号 payBatchNo 商家对账使用16. 代理商家名称 proxyMerName17. 代理商家类型 proxyMerType18. 代理商家证件号码proxyMercredentials19. 渠道编号 netTy
21、pe Y 0:html 渠道（默认 0）商户 API 报文交换规范14 / 415.1.3 商户结算账户余额查询请求报文：NULL5.1.4 批量订单查询请求报文：字段中文名 字段名 类型和长度 必输 备注1. 订单号列表 orders Y orders 是订单信息，多笔订单不超过 20笔，之间用|分隔；5.1.5 当批订单查询请求报文：字段中文名 字段名 类型和长度 必输 备注1 开始时间 beginTime Y yyyyMMddHHmmss2 结束时间 endTime Y yyyyMMddHHmmss3 订单状态 flag Y 0 所有 1 已支付 2 已撤销4 起始索引号 beginIn
22、dex5 起始订单号 beginOrder6 截至订单号 endOrder7 排序字段 sortField 1 订单号 2 金额 3 定单时间8 排序方式 sortOrder 1 降序 2 升序5.1.6 历史订单查询商户 API 报文交换规范15 / 41请求报文：字段中文名 字段名 类型和长度 必输 备注1. 开始时间 beginTime Y yyyyMMddHHmmss2. 结束时间 endTime Y yyyyMMddHHmmss3. 订单状态 flag Y 0 所有 1 已支付 2 已撤销 3 部分退货 4 退货处理中 5 全部退货4. 起始索引号 beginIndex5. 起始订单
23、号 beginOrder6. 截至订单号 endOrder7. 排序字段 sortField 1 订单号 2 金额 3 定单时间8. 排序方式 sortOrder 1 降序 2 升序5.1.7 退款明细查询请求报文：字段中文名 字段名 类型和长度 必输 备注1. 起始日期 begDate Y yyyyMMdd2. 结束日期 endDate Y yyyyMMdd3. 退款类型 refundType Y 0 所有 1 支付撤销 2 退货4. 订单号 order5. 交易状态 flag Y 0 所有 1 成功 2 失败6. 起始索引号 begindex5.1.8 退款录入请求报文：字段中文名 字段名
24、 类型和长度 必输 备注1. 商户操作员号 operator Y2. 订单号 order Y3. 订单日期 date Y yyyyMMdd4. 退款金额 amount Y5. 退款备注 comment商户 API 报文交换规范16 / 415.1.9 直接退款请求报文：字段中文名 字段名 类型和长度 必输 备注1. 商户操作员号 operator Y2. 订单号 order Y3. 订单日期 date Y yyyyMMdd4. 退款金额 amount Y5. 退款备注 comment6. 并单标志 gatherFlag Y 0 并单 1 不并单7. 并单号 gatherNo Y 并单编号”由
25、6 为数字组成，用于区分是否为同一笔并单5.1.10 结算明细下载请求报文：字段中文名 字段名 类型和长度 必输 备注1. 结算日期 date Y yyyyMMdd5.1.11 持卡人身份验证（VIP 商户）请求报文：字段中文名 字段名 类型和长度 必输 备注1. 银行卡号 cardNo Y2. 客户姓名 custName3. 证件类型 certType 15 居民身份证16 临时身份证17 军人身份证件18 武警身份证件19 港澳台居民通行证20 护照商户 API 报文交换规范17 / 4121 其他22 临时户口23 户口簿24 边境证4. 证件号码 certNo5.2 交易接口返回 XM
26、L 包我行的支付系统对商户通过 API 发起的交易请求给予的回应都以 XML 报文方式返回。在 API 提供的交易接口中，已对交易响应的 XML 报文进行了解析。5.2.1 结算账户余额查询返回码错误描述商户号结算账号账户名称币种当前余额 可用余额签名数据5.2.2 批量订单查询返回码错误描述商户 API 报文交换规范18 / 41商户号订单号 订单日期订单时间币种 CNY（人民币）金额支付日期支付时间支付交易状态 1成功订单状态0 未支付、1 已支付、2 已撤销、3 已部分退货、4退货处理中、5 已全额退货手续费 银行流水号银行批次号交易卡类型0:借记卡 1：准贷记卡 2:贷记卡商户批次号商
27、户备注银行备注签名数据5.2.3 当批订单查询返回码错误描述商户号总笔数本次查询返回记录起始号订单号 订单日期商户 API 报文交换规范19 / 41订单时间币种 CNY（人民币）金额支付日期支付时间支付交易状态 1成功订单状态0 未支付、1 已支付、2 已撤销、3 已部分退货、4退货处理中、5 已全额退货手续费 银行流水号银行批次号交易卡类型0:借记卡 1：准贷记卡 2:贷记卡商户批次号商户备注银行备注签名数据5.2.4 历史订单查询查询返回码错误描述商户号总笔数本次查询返回记录起始号订单号 订单日期订单时间币种 CNY（人民币）金额支付日期支付时间支付交易状态 1成功商户 API 报文交换
28、规范20 / 41订单状态0 未支付、1 已支付、2 已撤销、3 已部分退货、4退货处理中、5 已全额退货手续费 银行流水号银行批次号交易卡类型0:借记卡 1：准贷记卡 2:贷记卡商户批次号商户备注银行备注签名数据5.2.5 退款明细查询返回码错误描述商户号总笔数本次查询返回记录起始号订单号 订单日期币种 CNY退款金额退款类型 1 支付撤销、2 退款退款日期退款时间退款交易状态 1成功；2失败 退款拒绝原因退款手续费 退款账号商户备注银行备注商户 API 报文交换规范21 / 41签名数据5.2.6 退款录入返回码错误描述商户号退款流水号退款账号签名数据5.2.7 对帐单下载返回码错误描述商
29、户号支付结算总金额支付结算总笔数手续费对帐文件内容签名数据商户 API 报文交换规范22 / 415.2.8 持卡人身份验证（VIP 商户使用）返回码错误描述签名数据5.2.9 当批订单完整查询返回码错误描述商户号订单号 订单日期订单时间币种 CNY（人民币）金额支付日期支付时间支付交易状态 1成功订单状态0 未支付、1 已支付、2 已撤销、3 已部分退货、4退货处理中、5 已全额退货手续费 银行流水号银行批次号交易卡类型0:借记卡 1：准贷记卡 2:贷记卡商户批次号商户备注银行备注商户 API 报文交换规范23 / 41签名数据5.3 API 联机交易签名与验签API 交易中发送请求数据的签
30、名与接收银行响应数据的验签，都由 API 内部封装并处理，不需要商户系统做其他处理。6 一键支付 API 交易报文6.1 一键支付跳转签约6.1.1 报文功能从商户端浏览器跳转到银行页面完成签约。商户 POST 请求参数到我行支付平台并附带签名数据。客户在我行系统输入卡号、户名等要素；如果是实名认证，那么客户需要验证证件类型、证件号码。我行验证客户输入要素无误后，提示客户继续输入交易密码、手机动态密码等信息。系统验证通过后，生成客户的一键支付协议。根据商户填写的返回页面 URL，系统会在客户签约成功后，提供客户返回商户网站的按钮。根据商户填写的主动通知 URL，系统会主动向该地址发送签约成功通
31、知。如果通知失败，系统会稍后重新发送三次，之后会丢弃该通知消息。商户可以通过跳转签约时设置的商户协议检索号，调用一键支付协议查询接口，查询客户签约结果。6.1.2 请求报文结构序号 报文要素 参数字段名 属性 类型 备注商户 API 报文交换规范24 / 411. 消息版本号 interfaceVersion 11 Max7Text 1.0.0.02. 商户协议检索号 merAgreeNo 11 Max20Text 商户生成，必填项，唯一标识，例如可填商户端用户注册 id3. 商户号 merID 11 Max15Text4. 签约户名 accName 01 Max30Text 户名、证件类型、
32、证件号：非必填项，用于实名认证。个人客户可在商户端填写，也在直接在银行页面输入。5. 证件类型 certType 01 Max20Text 15:身份证 17:军人证 18:警官证 19:通行证 20:护照 21:其它 24:回乡证6. 证件号 certNo 01 Max30Text7. 返回页面 URL merURL 01 提供客户签约完成后返回到商户网站8. 主动通知 URL notifyURL 11 系统主动向此地址发送签约成功通知9. 商户备注 merComment 01 Max200Text 如果是中文长度为 10010. 交易类型 onekeyTranType 11 0:普通认证
33、1:实名认证11. 渠道编号 netType 11 固定送 06.1.3 响应报文结构中文名称 英文名称 属性 类型 备注1. 商户号 merID 11 Max15Text2. 协议检索号 merAgreeNo 11 Max20Text3. 协议号 ptcId 11 Max20Text4. 订单日期 orderDate 11 Date5. 卡类型 cardType 11 Max1Text 0、1：借记卡商户 API 报文交换规范25 / 412：贷记卡6. 卡号 cardNoMask 11 Max30Text 掩码处理例如：62258821*9647. 手机号 mobileNoMask 11
34、Max11Text 掩码处理例如：1592*3178. 商户备注 merComment 11 Max100Text9. 银行备注 bankComment 11 Max100Text10. 银行签名 signMsg 11 Max2048Text6.1.4 报文说明通过 request.getParameter(“notifyMsg”)方式，可得到交通银行支付平台发送到商户的支付结果返回项如下：notifyMsg=301310081119500|20120314140624|BOC100000000000638|20120314|0|622260*400|1350*009| |6222600110
35、044033400| MIIHaQYJKoZIhvcNAQcCoIIHWjCCB1YCAQExC原文：301310081119500|20120314140624|BOC100000000000638|20120314|0|622260*400|1350*009| |6222600110044033400|签名项：MIIHaQYJKoZIhvcNAQcCoIIHWjCCB1YCAQExC得到原文，截取支付结果中的签名信息，通过交通银行签名组件的 Detached 方式进行验签。6.2 一键支付协议查询6.2.1 报文功能用户可以在商户网站查询通过该商户在我行支付系统签约的一键支付协议。商户使用
36、我行提供的 API 开发包，调用一键支付协议查询接口，组织查询请求 XML报文报文。输入查询要素可以查询满足查询条件的，通过该商户在我行签约的一键支付协商户 API 报文交换规范26 / 41议。商户按照商户号+协议检索号查询单笔协议情况，也可以通过商户号+签约起始日期+签约截止日期，查询某个区间签约的协议；6.2.2 请求报文结构序号 报文要素 属性 类型 备注1. 商户号 01 Max15Text2. 协议检索号 01 Max20Text 唯一，商户查询，非汉字6.2.3 响应报文结构序号 报文要素 属性 类型 备注1. 返回代码 11 Max6Text2. 返回信息 11 Max56Nu
37、mericText3. 4. -协议号 115. -商户协议检索号 116. -签约卡类型 117. -账户开户分行 118. -商户备注 119. -银行备注 1110. -协议状态 116.2.4 报文说明6.3 一键支付协议撤销6.3.1 报文功能商户使用我行提供的 API 开发包，调用一键支付协议撤销接口，组织查询请求 XML报文报文，向我行支付系统提交协议撤销申请。商户 API 报文交换规范27 / 416.3.2 请求报文结构序号 报文要素 属性 类型 备注1. 商户号 11 Max15Text2. 协议号 11 Max20Text6.3.3 响应报文结构序号 报文要素 属性 类型
38、 备注1. 返回代码 11 Max6Text2. 返回信息 11 Max56NumericText6.3.4 报文说明无6.4 发送客户验证短信6.4.1 报文功能商户使用我行提供的 API 开发包，调用发送客户验证短信接口，组织查询请求 XML报文报文，向我行支付系统提交发送客户验证短信申请。短信版支付前，向客户手签约预留手机号发送手机动态密码，用于客户支付时输入使用；并返回商户识别码（sessionID） ，用于短信版支付时系统验证手机动态密码使用。短信动态验证码的有效期为 15 分钟，用户必须在系统发送短信验证码后的 15 分钟内进行身份验证，超过有效期的业务请求需重新请求用户动态短信验
39、证码。6.4.2 请求报文结构序号 报文要素 属性 类型 备注1. 商户号 11 Max15Text2. 协议号 11 Max20Text3. 商户协议检索号 11 Max30Text商户 API 报文交换规范28 / 414. 交易金额 11 Amount5. 申请时间 11 DateTime6. 交易渠道 11 Max1Text 固定送：06.4.3 响应报文结构序号 报文要素 属性 类型 备注1. 返回代码 11 Max8Text2. 识别码 11 Max80Text6.4.4 报文说明无6.5 重发客户验证短信6.5.1 报文功能商户使用我行提供的 API 开发包，重发已经过送的客户身
40、份验证短信版一键支付，客户没有收到我行发送的动态密码短信，商户可以调用此接口重新发送原手机动态密码到客户签约时预留的手机。短信动态验证码的有效期为 15 分钟，用户必须在系统发送短信验证码后的 15 分钟内进行身份验证，超过有效期的业务请求需重新请求用户动态短信验证码。6.5.2 请求报文结构序号 报文要素 属性 类型 备注1. 商户号 11 Max15Text2. 识别码 11 Max80Text商户 API 报文交换规范29 / 416.5.3 响应报文结构序号 报文要素 属性 类型 备注3. 返回代码 114. 返回信息 115. 识别码 116. 已重发次数 11 系统最多重发三次6.
41、5.4 报文说明无6.6 短信版支付6.6.1 报文功能该报文提供给商户系统生成订单，提供给买方付款时使用。调用该接口前，商户必须调用“发送客户验证短信”接口。商户根据我行接口要素，组织订单数据，并且需要填写客户在我行签约生成的协议号以及商户端的协议检索号。6.6.2 请求报文结构序号 报文要素 属性 类型 备注3. 消息版本号 11 Max7Text 1.0.2.04. 手机动态密码 11 Max10Text5. 识别码 11 Max80Text6. 协议号 11 Max20Text7. 商户协议检索号 01 Max30Text 商户生成，应保证唯一性8. 商户客户号（商户编号）11 Max
42、15Text 商户客户号是银行生成的 15 位编号9. 订单号 11 Max20Text 商户应保证 3 个月以上的唯一性商户 API 报文交换规范30 / 4110. 商户订单日期 11 Date Yyyymmdd11. 商户订单时间 11 Time Hhmmss12. 交易类别 11 Max1Text 0 B2C13. 订单金额 11 Amount 单位:元 并带两位小数15 位整数+2 位小数14. 订单币种 11 Max3Text 人民币 CNY15. 订单内容 01 Max100Text 商家填写的其他订单信息，在个人客户页面显示16. 商家备注 01 Max100Text 不在个人
43、客户页面显示的备注，但可在商户管理页面上显示17. 物流配送标志 01 Max1Text 0 非物流 1 物流配送18. 通知方式 01 Max1Text 0 不通知 1 通知 2 转页面19. 主动通知 URL 01 Max100Text 为空则不发通知20. 商户批次号 01 Max10Text 商家可填入自己的批次号，对账使用21. 代理商家名称 01 Max30Text 二级商户编号/或证件号码22. 代理商家证件类型 01 Max4Text 代理商家证件类型23. 代理商家证件号码 01 Max20Text 代理商家证件号码24. 渠道编号 11 Max1Text 固定填 0:（html渠道）6.6.3 响应报文结构序号 报文要素 属性 类型 备注7. 返回代码 Max6Text8. 返回信息 Max56Text9. 商户号
