通联支付网络服务股份有限公司

Transcription

1 通联支付网络服务股份有限公司 商户接口说明 版本 v4.1.7 通联支付网络服务股份有限公司 2016 年 1 月 15 日

2 文件修改记录 修改说明版本变更时间 新建 重整原有网关文档内容 增加订单批量查询接口 说明 修改单笔分账业务示例 完善请求报文格式说明 增加手机网关接入地址说明 完善通联网关接入文档内容, 新增手续费收取业 务说明 调整签名方式说明 更正分账业务说明 增加订单唯一性说明 调整订单过期时间说明 增加人民币跨境商户直连模式要求说明 退款申请接口升级 增加退款查询接口 支持跨境商户接入 支付网关接口不再支持 wap 支付 更新民生银行 B2B 接口 支持固定卡号支付 通知支付结果处理流程新增 8( 通知结果支持 https) 更新 B2C B2B 支持银行列表及机构代码

3 更新证件类型 更新 B2C 支持银行列表及机构代码

4 目录 1. 目的 通联互联网支付网关业务简介 名词解释 商户与通联合作程序 支付业务流程 通联互联网支付网关的网银支付流程 通知支付结果处理流程 退款流程... 7 a) 轧差退款... 7 b) 收支两条线退款 商户系统接入接口定义 页面订单提交接口 支付结果返回接口 单笔订单查询接口 单笔订单查询结果返回接口 批量订单查询接口 批量订单查询结果返回接口 单笔订单退款申请接口 单笔订单退款申请接口返回 退款状态查询接口 退款状态查询返回 商户汇率查询接口 商户汇率查询结果返回接口 业务扩展字段 exttl 介绍 单笔分账业务 格式 参数说明 分账示例 单笔手续费收取业务 格式 规则说明 手续费示例 海关扩展字段要求 签名及验签机制 进行 MD5 加密的签名源串及顺序 签名 验签 开发 开发步骤 Java 环境 ASP 和 dotnet 环境... 24

5 5.1.3 PHP 环境 示例代码 (Java) 商户网站对交易订单的报文组装关键代码 商户网站对交易结果的签名验证关键代码 附录 系统错误码 系统异常码 证件类型 B2C 支持银行代码 B2B 支持银行代码 ( 跨境支付商户暂不支持 B2B 支付 ) 币种类型 国家和币种代码 ( 参考资料 )... 33

6 1. 目的 本文档为使用通联互联网支付网关的商户开发者编写 本文档为通联互联网支付网关的开发者和相关人员提供有效的指引和帮助 本文档的目标读者为技术人员 2. 通联互联网支付网关业务简介 2.1 名词解释 客户 持卡人 : 是指支付过程中的付款方, 通常分为 个人客户 和 公司客户 商户 : 是指支付过程中的收款方, 商户需要向我司相关部门申请后获得商户身份, 完成商户开户后会分配一个商户号给该商户 通联支付网关 (Payment Gateway): 是银行金融网络系统和 Internet 网络之间的接口, 本文档中的通联支付网关是通联处理商家支付信息和顾客的支付指令并连接各银行完成支付业务的银行前置系统 2.2 商户与通联合作程序 1. 商户与通联签订商户接入协议, 通联为商户在通联支付网关系统开户 2. 通联为该商户提供测试环境地址 商户号 KEY 值及证书, 同时向商户提供支付网关 的开发包与接入开发指南 3. 商户系统加载开发包, 完成客户端开发并与通联支付网关测试系统进行联机测试 4. 商户测试环境联调成功后, 通联向商户发放生产商户号 KEY 值 正式证书 1) 通联业务人员配置商户证书基本信息, 生成商户证书 2) 通联业务人员审核允许商户下载证书 3) 商户登录通联商户服务网站下载证书 5. 商户参数配置 1) 商户在通联注册的商户号 2) 交易类型 3) 通知接收地址 4) 加密方式 5) 其他支付参数 6. 通联为商户开通互联网支付网关的接入权限 7. 投入生产 8. 清算结算及差错处理 9. 报表下载 2.3 支付业务流程 通联互联网支付网关的网银支付流程 1. 客户在商户网站选择商品, 商户网站创建一个订单支付请求, 支付参数采用 HTTP 表单 (FORM) 方式提交 ( 订单上送格式参见 3.1 小节页面订单提交接口 ) 2. 客户点击支付按钮, 将订单发送到通联互联网支付网关的支付页面, 支付页面路径如下 : http(s):// 通联支付网关地址 /gateway/index.do

7 3. 支付网关验证订单支付请求, 显示支付页面 4. 客户在支付页面上选择网银支付 5. 网关把客户浏览器转发到网银系统完成支付 6. 网关接收到网银系统的支付结果, 如果成功, 网关根据商户支付订单请求中的通知数据配置发送支付结果信息给商户网站 ( 支付结果返回数据参见 3.2 小节支付结果返回接口 ) 通知支付结果处理流程 1. 持卡人付款成功后, 支付网关接收到银行支付结果, 服务端将支付结果通知给商户, 有两种通知方式 : 页面通知和后台通知 2. 商户上送订单支付请求中有 receiveurl( 商户上送的后台通知地址 ) 和 pickupurl( 商户上送的页面通知地址 ) 两字段, 如果两个参数都填写, 则服务端后台通知到 receiveurl 地址, 页面跳转方式通知到 pickupurl 地址 3. 如果商户网站提交的支付请求中没有 receiveurl 参数, 只有 pickupurl 参数, 则以页面跳转方式通知到 pickupurl 地址, 从网关服务器发起到商户网站的 pickupurl 连接请求, 再把客户的浏览器转向到 pickupurl 地址, 将支付结果 post 到 pickupurl 地址所在页面, 同时服务端后台也通知到 pickupurl 地址 4. 如果商户网站提交的支付请求中没有 pickupurl 参数, 只有 receiveurl 参数, 则以后台方式通知商户到 receiveurl 地址, 从网关服务器发起到商户网站的 receiveurl 连接请求, 将支付结果 post 到 receiveurl 地址, 同时页面也会跳转到 receiveurl 地址 5. 一般建议商户两个地址都上送, 分别处理后台通知和页面跳转通知 6. 商户网站接收到连接请求, 处理对应的订单结果, 支付结果返回报文格式 ( 参见 3.2 小节支付结果返回接口 ) 7. 只要通知成功则停止通知, 若从网关服务器发起的到商户网站的 url 连接请求失败, 则把对应的 url 连接请求发送到系统重发队列中, 最多重发 3 次 8. 通知服务支持 https 的通知, 但是要求 https 是支持 TLS 协议的, 且不能为 SSL 双向验证的 退款流程 a) 轧差退款 1. 商户 T 日通过退款申请接口或者通过登录商户服务网站发起退款申请 ; 2. 通联实时反馈成功收到退款申请 ; 3. 通联从商户 T+1 日的结算资金中, 轧差出退款金额 ; 4. 通联 T+1 日向银行发起退款申请 ; 5. 退款资金 3-5 个工作日内返还至持卡人账户 b) 收支两条线退款 1. 商户通过退款申请接口或者通过登录商户服务网站发起退款申请 ; 2. 商户通过线下处理的方式, 转账给通联支付指定退款账户, 并通知通联对口的客户经理, 告知需要进行退款操作 ; 3. 客户经理通知通联运营人员, 检查退款资金到账 ; 4. 通联向银行发起退款申请 ; 5. 退款资金返还至持卡人账户

8 3. 商户系统接入接口定义 3.1 页面订单提交接口 商户网站创建的订单支付请求报文是符合 HTTP 表单 (Form) 的形式, 采用 MD5 签名 ( 参见第 4 小节签名机验签机制 ), 商户上送的 form 参数不允许含有空格字符, 因此保证各参数头尾空格 trim 注意 : 1 通联通过 merchantid orderdatetime 和 orderno 确定一笔订单, 且同一笔订单的订单金额必须相同, 如果是同一笔订单多次支付建议上述 3 个值上送时候保持不变 2 每笔订单可以设定过期时间, 超过过期时间 ( 最大时间 9999 分钟后 ) 的订单将被作废不允许支付 超过过期时间的订单要再支付的话, 商户需要跟换订单号 ( 或订单时间, 但更建议跟换订单号 ) 接入互联网网关地址 : 测试环境 : 生产环境 : 参数名称 参数含义 长度是否必填 参数说明 inputcharset 字符集 2 不可空 默认填 1;1 代表 UTF-8 2 代表 GBK 3 代表 GB2312; pickupurl 付款客户的取 100 不为空 客户的取货地址 货 url 地址 receiveurl 服务器接受支 100 不为空 通知商户网站支付结果的 url 地址 付结果的后台地址 version 网关接收支付 10 不可空 固定填 v1.0 请求接口版本 language 网关页面显示语言种类 2 不为空 默认填 1, 固定选择值 :1;1 代表简体中文 2 代表繁体中文 3 代表英文 signtype 签名类型 2 不可空 默认填 1, 固定选择值 :0 1; 0 表示订单上送和交易结果通知都使用 MD5 进行签名 1 表示商户用使用 MD5 算法验签上送订单, 通联交易结果通知使用证书签名 Asp 商户不使用通联 dll 文件签名验签的商户填 0 merchantid 商户号 30 不可空 数字串, 商户在通联申请开户的商户号 payername 付款人姓名 32 可为空 跨境支付商户若采用直连模式, 必须填写该值 payer payertelephone payeridcard 付款人邮件联系方式付款人电话联系方式付款人类型及证件号 50 可为空 字符串 16 可为空 数字串 22 可为空 填写规则 : 证件类型 + 证件号码再使用通联公钥加 密 ( 加密请参考示例代码 )

9 证件类型仅支持 01- 身份证跨境支付商户若采用直连模式, 必须填写该值 pid 合作伙伴的商户号 30 可为空 用于商户与第三方合作伙伴拓展支付业务,Partner merchantid orderno 商户订单号 50 不可空 字符串, 只允许使用字母 数字 - _, 并以字母或数字开头 ; 每商户提交的订单号, 必须在当天的该商户所有交易中唯一 orderamount 商户订单金额 10 不可空 整型数字, 金额与币种有关如果是人民币, 则单位是分, 即 10 元提交时金额应为 1000 如果是美元, 单位是美分, 即 10 美元提交时金额为 1000 ordercurrency 订单金额币种类型 3 不可空 默认填 0 0 和 156 代表人民币 840 代表美元 344 代表港币, 跨境支付商户不建议使用 0 orderdatetime 商户订单提交时间 14 不可空 日期格式 :yyyymmddhhmmss, 例如 : orderexpiredatetime 订单过期时间 14 可为空 整形数字, 单位为分钟 最大值为 9999 分钟 如填写则以商户上送时间为准, 如不填写或填 0 或填非法值, 则服务端默认该订单 9999 分钟后过期, 超期后不允许商户发起同一商户订单支付 productname 商品名称 256 可为空 英文或中文字符串, 请勿首尾有空格字符 productprice 商品价格 20 可为空 整型数字 productnum 商品数量 8 可为空 整型数字, 默认传 1 productid 商品代码 20 可为空字母 数字或 - _ 的组合 ; 用于使用产品数据 中心的产品数据, 或用于市场活动的优惠 productdesc 商品描述 400 可为空 英文或中文字符串 ext1 扩展字段 可为空 英文或中文字符串, 支付完成后, 按照原样返回给商户 ext2 扩展字段 可为空 英文或中文字符串, 支付完成后, 按照原样返回给商户 exttl 业务扩展字段 1024 可为空 参见 接口技术规范文档 3.9 节介绍 paytype 支付方式 2 不可空 固定选择值 : 接入互联网关时, 默认为间连模式, 填 0 若需接入外卡支付, 只支持直连模式, 即固定上送 paytype=23,issuerid=visa 或 mastercard 0 代表未指定支付方式, 即显示该商户开通的所有支付方式 1 个人储蓄卡网银支付 4 企业网银支付 11 个人信用卡网银支付 23 外卡支付

10 28 认证支付 非直连模式, 设置为 0; 直连模式, 值为非 0 的固 定选择值 issuerid 发卡方代码 8 可为空 银行或预付卡发卡机构代码, 用于指定支付使用的付款方机构 接入手机网关时, 该值留空 paytype 为 0 时,issuerId 必须为空 显示该商户支持的所有支付类型和各支付类型下支持的全部发卡机构 paytype 为非 0 时, 若 issuerid 为空 显示该商户所填 paytype 支付类型下的全部发卡机构 paytype 为非 0 时, 若 issuerid 不为空 直接跳转到该商户所填 paytype 下指定的发卡机构网银页面, 支持发卡机构详见附录 机构代码 pan 付款人支付卡号 19 可为空 数字串如果是民生银行 B2B 直连模式, 企业客户号, 必填 ; 如果是投融资行业希望支付卡号, 则必填上送的卡号必须使用公钥加密 (PKCS1) 后进行 Base64 编码 tradenature 贸易类型 2 可为空 固定选择值 :GOODS 或 SERVICES 当币种为人民币时选填当币种为非人民币时必填,GOODS 表示实物类型, SERVICES 表示服务类型 signmsg 签名字符串 1024 不可空 为防止非法篡改要求商户对请求内容进行签名, 供服务端进行校验 ; 签名串生成机制 : 按上述顺序所有非空参数与密钥 key 组合, 经加密后生成 signmsg; customsext 海关扩展字段 1024 可为空 详见 海关扩展字段要求 章节 3.2 支付结果返回接口 客户支付成功后, 网关返回支付结果到商户网站, 页面返回地址是商户提供的 receiveurl 或 pickupurl 地址 参数名称 参数含义 长度 可否为空 参数说明 merchantid 商户号 30 不可空 数字串, 与提交订单时的商户号保持一致 version language 网关返回支付结果接口版本网页显示语言种类 10 不可空固定选择值 :v1.0; 注意为小写字母 2 可空固定值 :1;1 代表中文显示

11 signtype 签名类型 2 不可空 固定选择值 :0 1, 与提交订单时的签名类型保持一致 paytype 支付方式 2 可空 字符串, 与提交订单时的支付方式一致 issuerid 发卡方机构代码 8 可空 固定为空 paymentorderid 通联订单号 50 不可空 字符串, 通联订单号 orderno 商户订单号 50 不可空 字符串, 与提交订单时的商户订单号保持一致 orderdatetime 商户订单提交时 间 14 不可空数字串, 与提交订单时的商户订单提交时间保持一致 orderamount 商户订单金额 10 不可空 整型数字, 金额与币种有关如果是人民币, 则单位是分, 即 10 元提交时金额应为 1000 如果是美元, 单位是美分, 即 10 美元提交时金额为 1000 paydatetime 支付完成时间 14 不可空 日期格式 :yyyymmddhhmmss, 例如 : payamount 订单实际支付金 额 10 不可空整型数字, 实际支付金额, 用户实际支付币种为人民 币 ; 以分为单位, 例如 10 元返回时应为 1000 分 ext1 扩展字段 可空 字符串, 与提交订单时的扩展字段 1 保持一致 ext2 扩展字段 可空 字符串, 与提交订单时的扩展字段 2 保持一致 payresult 处理结果 2 不可空 1: 支付成功仅在支付成功时通知商户 商户可以通过查询接口查询订单状态 errorcode 错误代码 10 可空 固定为空 returndatetime 结果返回时间 14 不可空 系统返回支付结果的时间, 日期格式 : yyyymmddhhmmss signmsg 签名字符串 1024 不可空 以上所有非空参数按上述顺序与密钥组合, 经加密后生成该值 3.3 单笔订单查询接口 商户可以根据此接口进行单笔订单查询, 单笔订单页面查询地址为 http(s):// 通联支付网关地址 /gateway/index.do 测试环境 : 生产环境 : 参数名称 参数含义 长度 可否为空 参数说明 merchantid 商户号 30 不可空 数字串, 与提交订单时的商户号保持一致 version 网关查询接 口版本 10 不可空固定值 :v1.5 signtype 签名类型 2 不可空固定选择值 :0 1; 与客户提交订单填写的值保持一 致

12 orderno 商户订单号 50 不可空字母 数字 - _ 及其组合, 与提交订单时的商户订 单号保持一致 orderdatetime querydatetime 商户订单提交时间商户提交查询的时间 14 不可空数字串, 与提交订单时的商户订单提交时间保持一致, 仅支持查询 ( 当前时间 -31 天 ) 以内的订单 14 不可空此时间不能与系统当前时间相差 15 分钟 signmsg 签名字符串 1024 不可空以上所有非空参数按上述顺序与密钥 key 组合, 经加 密后生成该值 3.4 单笔订单查询结果返回接口 单笔查询只返回支付成功的订单, 单笔订单查询的结果有两种处理方式 : 1 异步方式将交易结果通知到原交易发起时上送的 receiveurl, 接口与 支付结果返回接口 完全相同, 参见第 3.2 小节 2 同步返回结果, 通过解析通联返回的字符串, 验证签名信息再判断支付结果, 可参考范例代码 (JAVA:merchantOrderQuery.html &merchantorderquery.jsp; ASP: 参考 ETSClientDemo 工程 ) 备注 : 在验证签名前, 要先进行 URL decode 解析, 详情可见 JAVA:merchantOrderQuery.jsp APS: 参考 ETSClientDemo 工程 3.5 批量订单查询接口 商户可以根据此接口进行批量订单查询, 批量订单页面查询地址为 http(s):// 通联支付网关地址 /mchtoq/index.do 测试环境 : 生产环境 : 参数名称参数含义长度可否为空参数说明 version 网关批量查 询接口版本 10 不可空固定值 :v1.6 merchantid 商户号 30 不可空数字串, 与提交订单时的商户号保持一致 begindatetime enddatetime 查询订单的开始时间查询订单的结束时间 14 不可空 与 enddatetime 必须为同一天, 日期填写格式 : yyyymmddhh, 例如 : , 目前只支持对当天订单进行查询 14 不可空 与 begindatetime 必须为同一天, 日期填写格式 : yyyymmddhh, 例如 : , 查询时间范围为当天的 00:00:00~23:59:59 pageno 查询页码 2 不可空 从 1 开始, 必须为数字 signtype 签名类型 2 不可空 固定值 :1 signmsg 签名字符串 1024 不可空 以上所有非空参数按上述顺序与密钥 key 组合, 经加密后生成该值 3.6 批量订单查询结果返回接口 批量查询只返回支付成功的订单, 以文本同步方式返回, 每页返回最大笔数为 500 笔, 如果

13 有下一页请用户调用查询接口做下一页查询 每页最多返回 500 笔订单记录, 批量查询结果返回格式 : 汇总信息 + 交易明细 + 换行 + 签名信息, 商户根据首行的 是否有下一页 (Y/N) 来判断是否要做下一页查询, 处理结果 :1 代表支付成功 ;0 代表未支付 如果查询结果 无记录, 则只有汇总信息 ( 商户号, 笔数为 0, 页码为 0, 是否有下一页为 N)+ 换行 + 签名信息 ( 签名信息与上 行之间有一空行 ) 汇总信息 : 商户号 当页笔数 当前页码 是否有下一页 交易明细 : 商户号 通联订单号 商户订单号 商户订单提交时间 商户订单金额 支付完成时间 订单实际支付金额 扩展字段 1 扩展字段 2 处理结果 签名信息 : 对汇总信息 + 交易明细 + 换行用证书签名所得值 成功响应报文示例 : N NO KjZSXMf1nH6Q/wD22xI59ImN8Wzix15UcqA18pZeaWp7vQevMOA4UXTTX/mbqDAiTSEIwp3hQ8bVZnA oxi4trseauu6htrdqpltao/e8+a/7otcww0ifixpkd654rktyqsiezndw4tx1l5xcgsxbrajuem8krh CemZcAB8JlqRo= 异常响应报文 : ERRORCODE= 错误编码 &ERRORMSG=" 错误信息 ", 详见系统异常码 ps: 响应报文都是 Base64 编码后的内容, 客户端接收到响应内容后需要先解码, 详见提供的 demo 3.7 单笔订单退款申请接口 商户可根据此接口进行订单退款申请, 支持部分退款申请, 即退款金额 <= 订单金额, 联机退 款提交地址为 http(s):// 通联支付网关地址 /gateway/index.do 测试环境 : 生产环境 : 参数名称参数含义长度可否为 空 参数说明 version 网关联机退 款接口版本 4 不可空固定值 :v2.3 signtype 签名类型 1 不可空 0 表示订单上送和交易结果通知都使用 MD5 进行签名 1 表示商户用使用 MD5 算法验签上送订单, 通联交易结果通知使用证书签名 merchantid 商户号 30 不可空数字串, 与提交订单时的商户号保持一致 orderno 商户订单号 50 不可空字母 数字 - _ 及其组合, 与提交订单 时的商户订单号保持一致

14 refundamount 退款金额 10 不可空 整型数字, 金额与币种有关如果是人民币, 则单位是分, 即 10 元提交时金额应为 1000 如果是美元, 单位是美分, 即 10 美元提交时金额为 1000 系统支持部分退款, 但需保证退款金额 <= 订单金额 mchtrefundorderno 商户退款订单号 50 可空 字母 数字 - _ 及其组合, 如果填写, 退款结果原样返回 orderdatetime 商户订单提交时间 14 不可空 数字串, 与提交订单时的商户订单提交时间保持一致 signmsg 签名字符串 1024 不可空 以上所有非空参数按上述顺序与密钥 key 组合, 经加密后生成该值 3.8 单笔订单退款申请接口返回 参数名称 参数含义 长度 可否为 参数说明 空 merchantid 商户号 30 不可空 数字串, 与提交订单时的商户号保持一致 version 网关联机退款 10 不可空 固定值 :v2.3 接口版本 signtype 签名类型 2 不可空 固定选择值 :0 1; 与客户提交请求填写的值保持一致 orderno 商户订单号 50 不可空 字母 数字 - _ 及其组合, 与提交订单时的商户订单号保持一致 orderamount 商户订单金额 10 不可空 整型数字, 金额与币种有关如果是人民币, 则单位是分, 即 10 元提交时金额应为 1000 如果是美元, 单位是美分, 即 10 美元提交时金额为 1000 orderdatetime 商户订单提交时间 14 不可空 数字串, 与提交订单时的商户订单提交时间保持一致 refundamount 退款金额 10 不可空 整型数字, 金额与币种有关如果是人民币, 则单位是分, 即 10 元提交时金额应为 1000 如果是美元, 单位是美分, 即 10 美元提交时金额为 1000 refunddatetime 退款受理时间 14 不可空 数字串 退款申请受理的时间日期格式 : yyyymmddhhmmss 如 refundresult 退款结果 10 不可空 申请成功 :20 其他为失败 mchtrefundorderno 商户退款订单号 50 可空 字母 数字 - _ 及其组合, 如请求有填写, 退款结果原样返回 returndatetime 结果返回时间 14 不可空 数字串 退款申请完成的时间日期格式 : yyyymmddhhmmss 如

15 signmsg 签名字符串 1024 不可空 以上所有非空参数按上述顺序与密钥组合, 经加密 后生成该值 3.9 退款状态查询接口 可查询近一个月的退款订单状态 测试环境 : 生产环境 : 参数名称参数含义长度可否为空参数说明 version 退款查询版 本 4 不可空固定值 :v2.4 signtype 签名类型 1 不可空 0 表示订单上送和结果返回都使用 MD5 进行签名 1 表示商户用使用 MD5 算法签名上送订单, 通联返回使用证书签名 merchantid 商户号 30 不可空 数字串, 与提交订单时的商户号保持一致 orderno 商户订单号 50 不可空 字母 数字 - _ 及其组合, 与提交订单时的商户订单号保持一致 refundamount 退款金额 10 不可空 整型数字, 单位是分系统支持部分退款, 但需保证退款金额 <= 订单金额 refunddatetime 退款受理时间 14 可空 数字串 退款申请受理的时间日期格式 :yyyymmddhhmmss 如 mchtrefundorderno 商户退款订 单号 50 可空字母 数字 - _ 及其组合, 在 商户的系统里是唯一, 不可重复 3.10 退款状态查询返回 参数名称参数含义长度可否为空参数说明 version 退款查询版本 4 不可空固定值 :v2.4

16 signtype 签名类型 1 不可空 0 表示订单上送和结果返回都使用 MD5 进行签名 1 表示商户用使用 MD5 算法签名上送订单, 通联返回使用证书签名 merchantid 商户号 30 不可空 数字串, 与提交订单时的商户号保持一致 orderno 商户订单号 50 不可空 字母 数字 - _ 及其组合, 与提交订单时的商户订单号保持一致 refundamount 退款金额 10 不可空 整型数字, 单位是分系统支持部分退款, 但需保证退款金额 <= 订单金额 refunddatetime 退款受理时间 14 可空 数字串 退款申请受理的时间日期格式 :yyyymmddhhmmss 如 mchtrefundorderno 商户退款订单 号 50 可空字母 数字 - _ 及其组合, 在 商户的系统里是唯一, 不可重复 refundresult 退款结果 10 不可空参考成功码描述, 比如 TKSUCC0001 returndatetime 结果返回时间 14 不可空 数字串 退款申请完成的时间日期格式 :yyyymmddhhmmss 如 退款查询成功返回码 成功 返回码 返回码说明 1 TKSUCC0001 退款未受理 2 TKSUCC0002 待通联审核 3 TKSUCC0003 通联审核通过 4 TKSUCC0004 退款冲销 5 TKSUCC0005 处理中 6 TKSUCC0006 退款成功 7 TKSUCC0007 退款失败 8 TKSUCC0008 通联审核不通过 如果查询结果为一条记录, 则返回一条, 如果查询结果为多条记录, 则返回多条对于查询结果的签名放在记录后面, 举例如下 ( 红色部分为签名 ) 返回一条数据的例子如下 : v

17 TKSUCC v5qbvp990c0auh2c+bgz+kigieebopvysyckane5u7mhsewzhm1vfnb3puhv HwhV7eGWRJW8ubUh4pvc1gwydMxLu3zQQF9Tc2BUUB5Mr/lsqVo5lONCbAqU wq902zxapp2odomfa74mh3jmj5loozj1hf2sreuckjd4fvaonzy= 返回多条数据的例子如下, 注意 : 多条退款信息之间, 最后一条退款信息和签名之间都有回车符 \r\n v NO TKSUCC v NO TKSUCC RK/FcBQhhM0/GkjKFYkgxVLZwM8nFfM715UVVmcNgTiF7ZNAkhcM4PBvKO2di4vN3PsUwMYY kjkfqa6x0gygmk5tfv8blu4nrvmmvojdykqszpzz1bt11e0ktdxixdb+gcq4f2rtgugwzfuy k8o+ga8kp1ox/aiigqnrcfuxf9w= 验签时候 signstring = v NO TKSUCC \r\n + v NO TKSUCC ; signmsg= RK/FcBQhhM0/GkjKFYkgxVLZwM8nFfM715UVVmcNgTiF7ZNAkhcM4PBvKO2di4vN3 PsUwMYYkjkfqA6x0GYgMK5TFv8bLu4NrvMMvoJdYkqsZPZz1bt11E0KtdXIxdb+GCQ4F2rtg UgWZfuyk8O+ga8kp1OX/AiigqNrcFuXf9w= 退款查询失败返回, 只返回错误码, 如下 比如 :ERRORCODE=001& ERRORMSG= 商户号不能为空 退款查询错误码及描述 : 失败错误码错误描述 1 商户号不能为空 商户号不能超过 15 位 商户号不存在 订单号不能为空 订单号不存在 退款金额不能为空 退款金额必须大于 退款金额必须为整数 退款受理时间格式不匹配 摘要错误 退款订单不存在 011 1) 如果上传的 signtype 为 0, 则应用 MD5 验签 返回结果 : v NO TKSUCC B93C478F65CBB562122D367B262FC305 签名原串 : signstring= v NO TKSUCC

18 签名 : signmsg= B93C478F65CBB562122D367B262FC305 验签过程如下 : a. String filestring=signstring+ +key;(key 为商户的 md5key) b. String filemsg = SecurityUtil.MD5Encode(fileString); if(signmsg.equals(filemsg)){ 验签通过 }esle{ 验签不通过 } 备注 : 多条数据的 signstring,sinmsg, 可参考上批注 2) 如果上传的 signtype 为 1, 则应用证书验签返回结果 : v NO TKSUCC DQqfer2bKFcoQu01YiiLfLNPV7WPIK+vDtRUeEg2kdcrflkhZcuF4b8PHAD+2JSqMrUhIYXg /alnfw/bdd+i6gn0p3x2kpx26k3ivwowvxmrehnn/uv3d08g09w6/uaxpqwon+beztjljb7s M4rosIY/mEYPoS9A7IUCkk15GZo= 签名原串 : signstring= v NO TKSUCC 签名 : singmsg= DQqfer2bKFcoQu01YiiLfLNPV7WPIK+vDtRUeEg2kdcrflkhZcuF4b8PHAD+2JSqMrUhIYX g/alnfw/bdd+i6gn0p3x2kpx26k3ivwowvxmrehnn/uv3d08g09w6/uaxpqwon+beztjljb7 sm4rosiy/meypos9a7iuckk15gzo= 验签过程如下 : a. String filemd5string = SecurityUtil.MD5Encode(signString); b. boolean isverified = SecurityUtil.verifyByRSA(certPath,fileMd5String.getByte(),Base64.decode(signMs g)); c. If(isVerified){ 验签通过 }else{ 验签不通过 } 备注 :certpath 为证书路径 ; 多条数据的 signstring,sinmsg, 可参考上批注 ; ( 具体验签实例可参考 java 版 demo 示例 refundorderquerypost.jsp)

19 3.11 商户汇率查询接口 商户可以根据此接口进行商户汇率查询, 商户汇率页面查询地址为 http(s):// 通联支付网关地址 /mchtoq/mchtrate 测试环境 : 生产环境 : 参数名称 参数含义 长度 可否为空 参数说明 merchantid 商户号 30 不可空 数字串, 必须是通联给商户分配的商户号 version 网关查询接 口版本 10 不可空固定值 :v1.6 signtype 签名类型 2 不可空固定选择值 :1; currency 币种 3 不可空数字串, 参考 币种类型 章节 signmsg 签名字符串 1024 不可空以上所有非空参数按上述顺序与密钥 key 组合, 经加 密后生成该值 3.12 商户汇率查询结果返回接口 商户汇率查询以文本方式返回, 汇率查询结果返回格式 : 汇率信息 + 签名信息 ( 汇率信息和签名信息中间有回车换行符 \r\n ) 汇率信息 : 商户号 币种代码 汇率 汇率生效时间签名信息 : 对汇率信息用证书签名所得值 Base64 加密后的数据为 : MTAwMDIwMDAzMDAwfDk3OHw5LjE4MjZ8MjAxNC0wOS0xNyAxMDowNjo1Ng0KDQpNeEk2V1F3RVZZS0h3NzR JOFVEQitGUlR4MFd6c3luaFFGRXlueU9tU1hqclZyY1hxOGlPTHo1NGZSNVJ1U05oUGo4clZaQnZjTFdSbX dkrhr0b3bnrjvpzjn0yu9cwtuxuhfyewd6ek10tw9daxzlvfuvnem5c3fnuktglzfyn25mbhztz2jisevjs jbnavllm3rlv0hjqi84uly3bg9tqnd0ywvoohjitmc9 成功响应报文示例 :( 即将上面经过 Base64 加密后内容解码后的内容 ) :06:56 MxI6WQwEVYKHw74I8UDB+FRTx0WzsynhQFEynyOmSXjrVrcXq8iOLz54fR5RuSNhPj8rVZBvcLWRmwJDtto pgf5of3taoby51pqrygzzmtmocivetu/4c9sqmrkf/1r7nllvmgbhheij0giyk3tewhib/8rv7losbwtaeh 8rHNg= 异常响应报文 : ERRORCODE= 错误编码 &ERRORMSG=" 错误信息 ", 详见系统异常码 ps: 响应报文都是 Base64 编码后的内容, 客户端接收到响应内容后需要先解码, 解码后的文本是 UTF-8 编码, 详情见 demo 注 : 商户收到的是经过 Base64 加密过的数据, 通过以下步骤进行解密 1. 对得到收到的数据进行 Base6 解码得到两部分内容 a 汇率数据 b 签名

20 2.. 拿证书进行验签 : a) 签名原串 signsrc = :06:56 signsrcmd5=md5encode(signsrc); b) 签名 sginmsg = MxI6WQwEVYKHw74I8UDB+FRTx0WzsynhQFEynyOmSXjrVrcXq8iOLz54fR5RuSNhPj8rVZBvcLWRmw JDttopgF5Of3taOBY51PqrygzzMtMoCiveTU/4C9sqMRKF/1r7nLlvmgbHHEIJ0giYK3teWHIB/8RV7 losbwtaeh8rhng= c) 签名验证 : SecurityUtil.verifyByRSA(certPath, signsrcmd5.getbytes(), Base64.decode(signmsg)); 备注 : 具体验签实例可参考 java 版 demo 示例 singleexratequerypost.jsp 3.13 业务扩展字段 exttl 介绍 在页面订单提交接口报文中含有 exttl 字段, 该字段用于扩展通联业务需求而设置的, 商户 可以在该字段设置多个业务组合, 目前通联的扩展业务有单笔分账业务和单笔手续费收取业务 格式 :<TL>< 业务名 A> 业务规则 A</ 业务名 A> < 业务名 N> 业务规则 N</ 业务名 N></TL> 单笔分账业务 与通联签约单笔分账业务的商户, 可通过该字段上送分账配置 跨境支付商户暂不支持分账操作 格式 业务名 :A00001 业务规则 : 分账类型 通联账户号 1, 固定金额或比例 通联账户号 2, 固定金额或比例 参数说明 参数名称 长度 参数说明 分账类型 1 固定值 1 表示按固定金额分账 2 表示按比例分账 通联账户号 20 由通联分配的账户号 商户登录 通联商户服务平台 绑定分账账户, 系统为每个账户分配一个唯一的通联账户号 比例或固定金额 14 分账类型为 1 时, 该值单位为分, 整型, 如 :1000 表示 10 元分账类型为 2 时, 该值单位为百分比, 数值型, 保留两位有效小数, 如 :5.5 表示 5.5% 补充说明 : 1) 按固定金额分账时, 总金额不超过该笔订单金额 ; 按比例分账时, 总百分比不超过 100%; 2) 最多可配置 10 个通联账户号 ; 3) 因分账配置不合法导致无法正常分账的, 该笔订单金额将划至商户的余额账户中 4) 用 A00001 表示分账业务 分账示例 1) <A00001> , ,200</A00001>

21 表示按固定金额分账, 通联账户 分 10 元, 通联账户 分 2 元 2) <A00001> , ,0.5</A00001> 表示按比例分账, 通联账户 分 10%, 通联账户 分 0.5% Eg: 当商户开通了单笔分账业务, 那么需在扩展字段 exttl 中上送 : <A00001> , ,0.5</A00001> 单笔手续费收取业务通常情况商户接入通联网关, 通联默认是向商户收取手续费, 但为满足向持卡人收取手续费的需求, 商户在上送订单时可在 exttl 字段中设置手续费收取对象 跨境支付商户暂不支持设置手续费收取对象操作 首先运营人员向该商户针对指定支付方式和银行设置手续费收取对象, 可配置向商户和持卡人收取, 默认都是向商户收取 ; 若需向持卡人收取手续费, 商户则按规则在 exttl 字段上送手续费, 仅支持直连银行方式 (paytype 为非 0,issuerId 不为空 ), 支持的支付方式包括 : 个人网银 b2c 信用卡支付 企业网银支付 格式业务名 :U00010 业务规则 : 商户订单原始金额 ( 不包括手续费 ) 用户手续费金额单位分, 原订单金额 + 用户手续费金额 = orderamount 值 规则说明 1) 若向商户收取手续费, 则 exttl 字段不上送 2) 若向持卡人收取手续费, 则在 exttl 字段上送手续费规则 3) 若向持卡人收取手续费, 需指定支付方式和银行发卡机构 4) 手续费规则遵循签订合同约定, 支持 : 按每笔交易金额比率 按每笔固定手续费用 按每笔交易上下限额 5) 手续费金额和原订单金额单位均为分, 整数型, 若计算出不满足需四舍五入取整 手续费示例 Eg: 按每笔交易金额比率, 每笔 0.5%:<U00010> </U00010> 按每笔固定手续费用, 每笔 1 元 :<U00010> </U00010> 按每笔交易上下限额, 每笔 0.5%; 当手续费 <1 元则按每笔收 1 元 ; 当手续费 >10 元则每笔收 10 元 : <U00010> </U00010>,<U00010> </U00010>,<U00010> </U00010> 海关扩展字段要求接海关报关商户除需要上送基本订单字段外, 需加送以下字段, 并且需对加送的字段的值计算 MD5 摘要, 摘要值填入 ext2 中上送 请务必遵照既定格式输入 customsext 海关扩展字段 1024 接海关类重庆海关报关格式如下 : 商户必填 <GW_CUSTOMS><CUSTOMS_TYPE>HG001</CUSTOMS_TYPE ><BIZ_TYPE_CODE>1</BIZ_TYPE_CODE><ESHOP_ENT_C ODE>23456</ESHOP_ENT_CODE><ESHOP_ENT_NAME>ABC </ESHOP_ENT_NAME><GOODS_FEE>190</GOODS_FEE><T

22 AX_FEE>10</TAX_FEE></GW_CUSTOMS> CUSTOMS_TYPE: 海关类别 ( 通联分配的海关类别代码 HG001) BIZ_TYPE_CODE: 业务类型 ( 直购进口 :I10, 网购保税进口 :I20) ESHOP_ENT_CODE: 电商企业代码 (10 位海关代码 ) ESHOP_ENT_NAME: 电商企业名称 ( 企业备案的企业全称 ) GOODS_FEE: 商品货款金额 TAX_FEE: 税款金额备注 : 以上参数全为必输项, 货款金额和税款金额之和等于商户订单金额 ext2 值计算 : 签名原串 ext2src = customsext ext2value = MD5Encode(ext2esrc) MD5Encode() 方法参见 4. 签名及验签机制 eg: ext2src=<gw_customs><customs_type>hg001</customs_type><biz_type_code>i20</biz_ty PE_CODE><ESHOP_ENT_CODE> </ESHOP_ENT_CODE><ESHOP_ENT_NAME>ABC</ESH OP_ENT_NAME><GOODS_FEE>190</GOODS_FEE><TAX_FEE>10</TAX_FEE></GW_CUSTOMS> ext2value = 4B0FD304C5A D347EF3CEA67 4. 签名及验签机制 4.1 进行 MD5 加密的签名源串及顺序 为防止非法篡改要求商户对请求内容进行签名, 按第 3 小节中接口报文参数说明, 签名源串是由除 signmsg 字段以外的所有非空字段内容按照报文字段的先后顺序依次按照 字段名 = 字段值 的方式用 & 符号连接 举例说明 : 商户开发页面订单提交接口时, 签名源串 signsrc 为 : inputcharset=1&pickupurl= eceiveurl= =1&signType=1&merchantId= &payerName=mc&payer =mc@allinpay.c om&payertelephone= &orderno=no &orderamount=1&ordercur rency=0&orderdatetime= &productname=dell&productprice=100&productnu m=1&productid=p &productdesc=good&ext1=ext1&ext2=ext2 注意事项 : a. 所有填写值的字段按报文规范中的字段顺序放到签名字符串中参与签名 ; b. 签名字符串头部与尾部需要连接字符串 & ; c. 如果有字段内容为汉字, 则必须按照指定的或者默认的字符集编码 ;

23 4.2 签名 签名是为了防止从商户系统提交的支付请求被非法篡改 签名方法采用标准的 MD5 算法来计算签名字符串的消息摘要 签名规则 : 在签名源串末尾增加 MD5 密钥 (key), 其中密钥商户可以在通联支付网关商户服务网站上设置和维护, 然后使用 MD5 算法 (MessageDigest md = MessageDigest.getInstance("MD5")) 方法 ), 生成的字节再转换成十六进制字符串, 从而得到该签名字符串的消息摘要,signMsg 的值即此消息摘要 举例说明 : inputcharset=1&pickupurl= ult/display.do&receiveurl= recv.do&version=v1.0&language=1&signtype=1&merchantid= &payername= 苗翠花 &payer =miaoch@allinpay.com&payertelephone= &orderno=no &orderAmount=200&orderCurrency=0&orderDatetime= &productName= 笔记本电脑 &productprice=100&productnum=1&productid=p &productdesc= 商品描述 &ext1= 附加参数 1&ext2= 附加参数 2&payType=0&tradeNature=GOODS&key=******* 使用 MD5 算法对签名字符串计算摘要,MD5 中的字母需转换为大写字母, 例如上面的签名字符串所计算出的摘要为 CCFFF9C33B70FC B3E9BA1A2CC, 此值即为 signmsg 的字段值 md5 算法和十六进制转换代码示例 : public static String MD5Encode(String adata) throws SecurityException { String resultstring = null; try { MessageDigest md = MessageDigest.getInstance("MD5"); resultstring = bytes2hexstring(md.digest(adata.getbytes("utf-8"))); } catch (Exception e) { e.printstacktrace(); throw new SecurityException("MD5 运算失败 "); } return resultstring; } public static String bytes2hexstring(byte[] b) { String ret = ""; for (int i = 0; i < b.length; i++) { String hex = Integer.toHexString(b[i] & 0xFF); if (hex.length() == 1) { hex = '0' + hex; } ret += hex.touppercase();

24 } } return ret; 4.3 验签 验签是商户为了验证接收到的报文数据确实是通联支付系统发送的 商户接收到通联返回的应答报文, 解析报文中的 signtype 字段, 若 signtype 为 0 则使用 MD5 算法进行验签 ; 若 signtype 为 1 则使用通联提供的公钥证书进行验签 使用 MD5 算法验签 : 若 signtype 为 0, 在签名字符串末尾增加 MD5 密钥, 密钥是在通联支付网关会员服务网站上设置, 使用 MD5 算法计算该签名字符串的消息摘要, 将生成的摘要与通联返回的 signmsg 进行比对, 如果相等则验签通过, 反之不通过 使用通联公钥证书验签 : 若 signtype 为 1, 则使用通联的公钥证书进行验签, 调用通联提供的 allinpay-security-xxx.jar 中的 verify() 方法 5. 开发 5.1 开发步骤 Java 环境 1) 环境准备,JDK1.4 以上 2) 安装 MPI: 拷贝 allinpay-security-xxx.jar 及与 JDK 版本对应的 bcprov-jdkxx-xxx.jar 到开发环境 的 classpath 目录下 ASP 和 dotnet 环境 1) 环境准备 2) 安装 MPI: 确保 Microsoft.NET Framework2.0 已安装 ; 执行 regasm /codebase 命令向操作系统注册 ETSClient.dll 文件, 并将 BouncyCastle.Crypto.dll 文件放在与 ETSClient.dll 相同的目录下 ; 配置文件证书 ( 可采用任一配置方式 ): 方式一 商户指定证书路径, 验签时需对 PaymentResult 对象设置证书路径, paymentresult.setcertpath( 指定证书 TLCert.cer 路径 ); 方式二 若未指定证书路径, 也可拷贝 TLCert.cer 到 %System%\system32 目录下, 商 户需确保有权限访问 system32 下证书信息 ; 方式三 或者编辑 tlprop.ini 文件, 并保存到 %system% 目录下, 并根据 ini 文件设置 拷贝证书文件到相应目录,tlprop.ini 文件内容参看开发包示例 PHP 环境 windows 环境在 apache php4.4.7+mysql 下测试通过 linux 环境在 apache php 下测试通过 确保 Apache php mysql 已正确安装 确保 Apache 可以正确调用 php 环境解析 php 文件 Linux 环境下, 需导入 php 高精度函数库, 编译 php 时请加上 enable-bcmat 参数 如不 加此参数, 系统可能提示 :bcmul() 函数不可用, 因为 php 的高精度函数, 需要在编译 php

25 的时候加入 bcmat 模块, 在编译脚本里增添 enable-bcmath 后重新编译 重启 apache 即可 拷贝 php-rsa.php 文件到应用系统 注意文件的调用配置, 本示例中所有的文件都在相同目录下 post.html 为样例入口页面, 请商户自行修改 通联支付网关地址, 修改 pickupurl 和 receiveurl 为接受结果地址 参数修改请参考样例中的注释 5.2 示例代码 (Java) 示例代码对应的订单处理流程 : 1 提交订单, 加密生成 signmsg 2 提交订单 post.html post.xxp 支付网关页面 ->3 Server 通知支付结果 receive.xxp 4 客户浏览器导向商户取货地址 pickup.xxp 商户网站对交易订单的报文组装关键代码 <% // 页面编码要与参数 inputcharset 一致, 否则服务器收到参数值中的汉字为乱码而导致验证签名失败 request.setcharacterencoding("utf-8"); String msg=""; String key=request.getparameter("key"); String version=request.getparameter("version"); String language=request.getparameter("language"); String inputcharset= request.getparameter("inputcharset"); String merchantid=request.getparameter("merchantid"); String pickupurl=request.getparameter("pickupurl"); String receiveurl=request.getparameter("receiveurl"); String paytype=request.getparameter("paytype"); String signtype=request.getparameter("signtype"); String orderno=request.getparameter("orderno"); String orderamount=request.getparameter("orderamount"); String orderdatetime=request.getparameter("orderdatetime"); String ordercurrency=request.getparameter("ordercurrency"); String orderexpiredatetime=request.getparameter("orderexpiredatetime"); String payertelephone=request.getparameter("payertelephone"); String payer =request.getparameter("payer "); String payername=request.getparameter("payername"); String payeridcard=request.getparameter("payeridcard"); String pid=request.getparameter("pid"); String productname=request.getparameter("productname"); String productid=request.getparameter("productid"); String productnum=request.getparameter("productnum"); String productprice=request.getparameter("productprice"); String productdesc=request.getparameter("productdesc");

26 String ext1=request.getparameter("ext1"); String ext2=request.getparameter("ext2"); String exttl=request.getparameter("exttl"); String issuerid=request.getparameter("issuerid"); String pan=request.getparameter("pan"); String tradenature=request.getparameter("tradenature ");// 新增 贸易类型 字段 String sign=""; // 默认 payeridcard pan 无需上送, 以下代码可不需要 start // 若直连 telpshx 渠道,payerTelephone payername payeridcard pan 四个字段不可为空 // 其中 payeridcard pan 需使用公钥加密 (PKCS1 格式 ) 后进行 Base64 编码 if(null!=payeridcard&&!"".equals(payeridcard)){ try{ payeridcard = SecurityUtil.encryptByPublicKey("C:\\TLCert.cer", payeridcard); }catch(exception e){ e.printstacktrace(); } } if(null!=pan&&!"".equals(pan)){ try{ pan = SecurityUtil.encryptByPublicKey("C:\\TLCert.cer", pan); }catch(exception e){ e.printstacktrace(); } } // 默认 payeridcard pan 无需上送, 以上代码可不需要 end // 构造订单请求对象, 生成 signmsg com.allinpay.ets.client.requestorder requestorder = new com.allinpay.ets.client.requestorder(); if(null!=inputcharset&&!"".equals(inputcharset)){ requestorder.setinputcharset(integer.parseint(inputcharset)); } requestorder.setpickupurl(pickupurl); requestorder.setreceiveurl(receiveurl); requestorder.setversion(version); if(null!=language&&!"".equals(language)){ requestorder.setlanguage(integer.parseint(language)); } requestorder.setsigntype(integer.parseint(signtype)); requestorder.setpaytype(integer.parseint(paytype)); requestorder.setissuerid(issuerid); requestorder.setmerchantid(merchantid); requestorder.setpayername(payername); requestorder.setpayer (payer );

27 requestorder.setpayertelephone(payertelephone); requestorder.setpayeridcard(payeridcard); requestorder.setpid(pid); requestorder.setorderno(orderno); requestorder.setorderamount(long.parselong(orderamount)); requestorder.setordercurrency(ordercurrency); requestorder.setorderdatetime(orderdatetime); requestorder.setorderexpiredatetime(orderexpiredatetime); requestorder.setproductname(productname); if(null!=productprice&&!"".equals(productprice)){ requestorder.setproductprice(long.parselong(productprice)); } if(null!=productnum&&!"".equals(productnum)){ requestorder.setproductnum(integer.parseint(productnum)); } requestorder.setproductid(productid); requestorder.setproductdescription(productdesc); requestorder.setext1(ext1); requestorder.setext2(ext2); requestorder.setexttl(exttl); requestorder.setpan(pan); requestorder.settradenature(tradenature); requestorder.setkey(key); //key 为 MD5 密钥, 密钥是在通联支付网关会员服务网站上设置 String strsrcmsg = requestorder.getsrc(); // 此方法用于 debug, 测试通过后可注释 String strsignmsg = requestorder.dosign(); // 签名, 设为 signmsg 字段值 %> <!--1 订单通过 post 方式提交 ; 提交支付请求可以使用 http 或 https 方式, 建议使用 https 方式 2 通联支付网关地址 商户号及 key 值, 在接入测试时由通联提供 ; 通联支付网关地址 商户号, 在接入生产时由通联提供,key 值在通联支付网关会员服务网站上设置 --> 商户网站对交易结果的签名验证关键代码 <% request.setcharacterencoding("utf-8"); // 接收 Server 返回的支付结果 String merchantid=request.getparameter("merchantid"); String version=request.getparameter("version"); String language=request.getparameter("language"); String signtype=request.getparameter("signtype"); String paytype=request.getparameter("paytype"); String issuerid=request.getparameter("issuerid"); String paymentorderid=request.getparameter("paymentorderid"); String orderno=request.getparameter("orderno");

28 %> String orderdatetime=request.getparameter("orderdatetime"); String orderamount=request.getparameter("orderamount"); String paydatetime=request.getparameter("paydatetime"); String payamount=request.getparameter("payamount"); String ext1=request.getparameter("ext1"); String ext2=request.getparameter("ext2"); String payresult=request.getparameter("payresult"); String errorcode=request.getparameter("errorcode"); String returndatetime=request.getparameter("returndatetime"); String signmsg=request.getparameter("signmsg"); // 验签是商户为了验证接收到的报文数据确实是支付网关发送的 // 构造订单结果对象, 验证签名 com.allinpay.ets.client.paymentresult paymentresult = new com.allinpay.ets.client.paymentresult(); paymentresult.setmerchantid(merchantid); paymentresult.setversion(version); paymentresult.setlanguage(language); paymentresult.setsigntype(signtype); paymentresult.setpaytype(paytype); paymentresult.setissuerid(issuerid); paymentresult.setpaymentorderid(paymentorderid); paymentresult.setorderno(orderno); paymentresult.setorderdatetime(orderdatetime); paymentresult.setorderamount(orderamount); paymentresult.setpaydatetime(paydatetime); paymentresult.setpayamount(payamount); paymentresult.setext1(ext1); paymentresult.setext2(ext2); paymentresult.setpayresult(payresult); paymentresult.seterrorcode(errorcode); paymentresult.setreturndatetime(returndatetime); //signmsg 为服务器端返回的签名值 paymentresult.setsignmsg(signmsg); //signtype 为 "1" 时, 必须设置证书路径 paymentresult.setcertpath("c:/tlcert.cer");// 读取通联公钥证书存放路径 // 验证签名 : 返回 true 代表验签成功 ; 否则验签失败 boolean verifyresult = paymentresult.verify(); // 验签成功, 还需要判断订单状态, 为 "1" 表示支付成功 boolean paysuccess = verifyresult && payresult.equals("1"); if(paysuccess){ //TODO 商户订单处理 out.println(" 商户订单处理完成 "); } out.println("server 接收处理完成 ");

29 6. 附录 6.1 系统错误码 错误码 错误描述 请联系客服 未知的报文参数验证错误 未知的交易处理参数配置错误 不支持的字符编码格式 参数取货地址不正确 参数通知地址不正确 参数签名类型不正确 参数语言类型不正确 参数支付方式不正确 参数扩展参数 2 不正确 参数扩展参数 1 不正确 参数产品描述信息部正确 参数产品代码不正确 参数产品数量不正确 参数产品名称不正确 参数订单提交时间不正确 参数订单金额不正确 参数订单号不正确 参数付款人的 地址不正确 参数付款人的电话不正确 参数付款人名称不正确 参数报文版本号不正确 参数签名信息不正确 参数发卡机构号不正确 参数网银直连支付参数不正确 参数查询时间不正确 参数查询开始时间不正确 参数查询结束时间不正确

30 10026 参数异步接收查询结果的 URL 地址不正确 该笔订单不存在 该笔订单不符合退款条件 报文编码格式错误 系统参数配置错误 订单已经支付成功 不能重复提交订单 原订单不存在 商户支付配置错误或商户号不存在 商户未被授权接入系统 系统繁忙, 请稍后再试 密码不正确 卡不存在 商户无效 无效卡号 密码输入次数超限 6.2 系统异常码 异常码 TX10001 TX10002 TX10003 TX10004 TX10005 TX10006 TX10007 TX10008 TX10009 TX10010 TX10011 TX10012 TX10013 TX10014 TX10015 异常描述不支持的字符编码格式取货地址和通知地址不能同时为空取货地址不合法通知地址不合法版本号不合法商户号不合法付款人名称不合法付款人的 地址不合法订单号不合法订单金额不合法订单时间不能为空订单时间不合法产品名称不合法产品代码不合法产品描述信息不合法

31 TX10016 TX10017 TX10018 TX10019 TX10025 TX10026 TX10027 TX10029 TX10030 TX10031 MOQ00000 MOQ00001 MOQ00002 MOQ00003 MOQ00004 MOQ00005 MOQ00006 MOQ00007 MOQ00008 MOQ00009 MOQ00010 扩展参数 1 不合法扩展参数 2 不合法支付方式不合法签名类型不合法未指定支付方式付款人证件号不合法付款人支付卡号不合法币种非人民币时, 贸易类型不能为空查询时间不合法查询时间不能为空未知错误参数版本号不合法参数商户号不合法参数订单开始时间不合法参数订单结束时间不合法参数页码不合法参数签名方式号不合法参数签名信息不合法验证签名失败签名失败商户订单记录查询失败 6.3 证件类型 证件类型 证件类别 01 身份证 ( 目前仅支持身份证 ) 02 军官证 03 护照 04 回乡证 05 台胞证 06 警官证 07 士兵证 99 其它证件

32 6.4B2C 支持银行代码 机构代码 机构名称 cmb 招商银行 ( 支持借 贷 ) icbc 中国工商银行 ( 支持借 贷 ) ccb 中国建设银行 ( 支持借 贷 ) abc 中国农业银行 ( 支持借 贷 ) cmbc 中国民生银行 ( 支持借 贷 ) spdb 上海浦东发展银行 ( 支持借 贷 ) hxb 华夏银行 ( 支持借 贷 ) cgb 广东发展银行 ( 支持借 贷 ) cib 兴业银行 ( 支持借 贷 ) ceb 光大银行 ( 支持借 贷 ) comm 交通银行 ( 支持借 贷 ) boc 中国银行 ( 支持借 贷 ) citic 中信银行 ( 支持借 贷 ) bos 上海银行 ( 支持借 贷 ) pingan 平安银行 ( 支持借 ) psbc 邮政储蓄 ( 支持借 贷 ) b1556 华融湘江银行 ( 支持借 ) dalian 大连银行 ( 支持借 ) b1541 贵阳银行 ( 支持借 ) b1593 宁波银行 ( 支持借 ) b1660 浙江泰隆商业银行 ( 支持借 ) b1669 枣庄银行 ( 支持借 贷 ) b1552 汉口银行 ( 支持借 贷 ) b1608 齐商银行 ( 支持借 ) b1629 泰安银行 ( 支持借 ) nb_unionpay 银联在线 ( 支持借 ) vbank 虚拟银行 ( 仅用于测试环境 ) 6.5B2B 支持银行代码 ( 跨境支付商户暂不支持 B2B 支付 ) 机构代码 cmb icbc ccb abc cmbc spdb ceb comm boc 机构名称招商银行中国工商银行中国建设银行中国农业银行中国民生银行上海浦东发展银行光大银行交通银行中国银行

33 cib 兴业银行 pingan 平安银行 psbc 邮政储蓄银行 b1541 贵阳银行 vbank 虚拟银行 ( 仅用于测试环境 ) 6.6 币种类型 币种代码 币种描述 0 或 156 人民币, 建议跨境商户提交 美元 344 港币 392 日元 978 欧元 458 马来西亚吉特 032 澳元 6.7 国家和币种代码 ( 参考资料 ) Country/Region Name Numeric Alpha Currency Name Numeric Alpha Decimal Digit Afghanistan 004 AFG Afghani 971 AFN 2 Albania 008 ALB Lek 008 ALL 2 Algeria 012 DZA Algerian Dinar 012 DZD 2 American Samoa 016 ASM U.S. Dollar 840 USD 2 Andorra 020 AND Euro 978 EUR 2 Angola 024 AGO Angola Kwanza 973 AOA 2 Anguilla 660 AIA East Caribbean Dollar 951 XCD 2 Antarctica 010 ATA No universal currency Antigua and Barbuda 028 ATG East Caribbean Dollar 951 XCD 2 Argentina 032 ARG Argentine Peso 032 ARS 2 Armenia 051 ARM Armenian Dram 051 AMD 2 Aruba 533 ABW Aruban Guilder 533 AWG 2 Australia 036 AUS Australian Dollar 036 AUD 2 Austria 040 AUT Euro 978 EUR 2 Azerbaijan 031 AZE Azerbaijanian Manat 944 AZN 2 Bahamas 044 BHS Bahamian Dollar 044 BSD 2 Bahrain 048 BHR Bahraini Dinar 048 BHD 3 Bangladesh 050 BGD Taka 050 BDT 2 Barbados 052 BRB Barbados Dollar 052 BBD 2 Belarus 112 BLR Belarussian Ruble 974 BYR 0 Belgium 056 BEL Euro 978 EUR 2

34 Country/Region Name Numeric Alpha Currency Name Numeric Alpha Decimal Digit Belize 084 BLZ Belize Dollar 084 BZD 2 Benin 204 BEN CFA Franc BCEAO 952 XOF 0 Bermuda 060 BMU Bermudian Dollar 060 BMD 2 Bhutan 064 BTN Indian Rupee 356 INR 2 Ngultrum 064 BTN 2 Bolivia 068 BOL Boliviano 068 BOB 2 Mvdol 984 BOV 2 Bosnia and Herzegovina 070 BIH Convertible Mark 977 BAM 2 Botswana 072 BWA Pula 072 BWP 2 Bouvet Island 074 BVT Norwegian Krone 578 NOK 2 Brazil 076 BRA Brazilian Real 986 BRL 2 British Indian Ocean Territory 086 IOT U.S. Dollar 840 USD 2 Brunei Darussalam 096 BRN Brunei Dollar 096 BND 2 Bulgaria 100 BGR Bulgarian Lev 975 BGN 2 Burkina Faso 854 BFA CFA Franc BCEAO 952 XOF 0 Burundi 108 BDI Burundi Franc 108 BIF 0 Cambodia 116 KHM Riel 116 KHR 2 Cameroon 120 CMR CFA Franc BEAC 950 XAF 0 Canada 124 CAN Canadian Dollar 124 CAD 2 Cape Verde 132 CPV Cape Verde Escudo 132 CVE 2 Cayman Islands 136 CYM Cayman Islands Dollar 136 KYD 2 Central African Republic 140 CAF CFA Franc BEAC 950 XAF 0 Chad 148 TCD CFA Franc BEAC 950 XAF 0 Chilean Peso 152 CLP 0 Chile 152 CHL Unidades de fomento 990 CLF 0 China 156 CHN Yuan Renminbi 156 CNY 2 Christmas Island 162 CXR Australian Dollar 036 AUD 2 Cocos (Keeling) Islands 166 CCK Australian Dollar 036 AUD 2 Colombian Peso 170 COP 2 Colombia 170 COL Unidad de Valor Real 970 COU 2 Comoros 174 COM Comoro Franc 174 KMF 0 Congo 178 COG CFA Franc BEAC 950 XAF 0 Democratic Republic of the Congo 180 ZAR Congolese Franc 976 CDF 2 Cook Islands 184 COK New Zealand Dollar 554 NZD 2

35 Country/Region Name Numeric Alpha Currency Name Numeric Alpha Decimal Digit Costa Rica 188 CRI Costa Rican Colon 188 CRC 2 Côte D Ivoire 384 CIV CFA Franc BCEAO 952 XOF 0 Croatia 191 HRV Kuna 191 HRK 2 Cuba 192 CUB Cuban Peso 192 CUP 2 Peso Convertible 931 CUC 2 Cyprus 196 CYP Euro 978 EUR 2 Czech Republic 203 CZE Koruna 203 CZK 2 Denmark 208 DNK Danish Krone 208 DKK 2 Djibouti 262 DJI Djibouti Franc 262 DJF 0 Dominica 212 DMA East Caribbean Dollar 951 XCD 2 Dominican Republic 214 DOM Dominican Peso 214 DOP 2 East Timor 626 TMP Rupiah 360 IDR 0 Ecuador 218 ECU U.S.Dollar 840 USD 2 Egypt 818 EGY Egyptian Pound 818 EGP 2 El Salvador 222 SLV El Salvador Colon 222 SVC 2 U.S.Dollar 840 USD 2 Equatorial Guinea 226 GNQ CFA Franc BEAC 950 XAF 0 Eritrea 232 ERI Nafka 232 ERN 2 Estonia 233 EST Euro 978 EUR 2 Ethiopia 230 ETH Ethiopian Birr 230 ETB 2 Faroe Islands 234 FRO Danish Krone 208 DKK 2 Falkland Islands Falkland Islands 238 FLK (Malvinas) Pound 238 FKP 2 Fiji 242 FJI Fiji Dollar 242 FJD 2 Finland 246 FIN Euro 978 EUR 2 France 250 FRA Euro 978 EUR 2 French Guiana 254 GUF Euro 978 EUR 2 French Polynesia 258 PYF CFP Franc 953 XPF 0 French Southern Territories 260 ATF Euro 978 EUR 2 Gabon 266 GAB CFA Franc BEAC 950 XAF 0 Gambia 270 GMB Dalasi 270 GMD 2 Georgia 268 GEO Lari 981 GEL 2 Germany, Republic of 276 DEU Euro 978 EUR 2 Ghana 288 GHA Cedi 936 GHS 2 Gibraltar 292 GIB Gibraltar Pound 292 GIP 2 Greece 300 GRC Euro 978 EUR 2 Greenland 304 GRL Danish Krone 208 DKK 2 Grenada 308 GRD East Caribbean Dollar 951 XCD 2

36 Country/Region Name Numeric Alpha Currency Name Numeric Alpha Decimal Digit Guadeloupe 312 GLP Euro 978 EUR 2 Guam 316 GUM U.S. Dollar 840 USD 2 Guatemala 320 GTM Quetzal 320 GTQ 2 Guinea 324 GIN Guinea Franc 324 GNF 0 Guinea-Bissau 624 GNB CFA Franc BCEAO 952 XOF 0 Guyana 328 GUY Guyana Dollar 328 GYD 2 Haiti 332 HTI Gourde 332 HTG 2 US Dollar 840 USD 2 Heard and McDonald Islands 334 HMD Australian Dollar 036 AUD 2 Honduras 340 HND Lempira 340 HNL 2 Hong Kong 344 HKG Hong Kong Dollar 344 HKD 2 Hungary 348 HUN Forint 348 HUF 2 Iceland 352 ISL Iceland Krona 352 ISK 2 India 356 IND Indian Rupee 356 INR 2 Indonesia 360 IDN Rupiah 360 IDR 0 Iran, Islamic Republic of 364 IRN Iranian Rial 364 IRR 2 Iraq 368 IRQ Iraqi Dinar 368 IQD 3 Ireland 372 IRL Euro 978 EUR 2 Israel 376 ISR Israeli Shekel 376 ILS 2 Italy 380 ITA Euro 978 EUR 2 Jamaica 388 JAM Jamaican Dollar 388 JMD 2 Japan 392 JPN Yen 392 JPY 0 Jordan 400 JOR Jordanian Dinar 400 JOD 3 Kazakhstan 398 KAZ Tenge 398 KZT 2 Kenya 404 KEN Kenyan Shilling 404 KES 2 Kiribati 296 KIR Australian Dollar 036 AUD 2 Korea, Democratic North Korean 408 PRK People s Republic of Won 408 KPW 2 Korea, Republic of 410 KOR Won 410 KRW 0 Kuwait 414 KWT Kuwaiti Dinar 414 KWD 3 Kyrgyzstan 417 KGZ SOM 417 KGS 2 Lao People s Democratic Republic 418 LAO Kip 418 LAK 2 Latvia 428 LVA Latvian Lats 428 LVL 2 Lebanon 422 LBN Lebanese Pound 422 LBP 2 Lesotho 426 LSO Loti 426 LSL 2 Rand 710 ZAR 2 Liberia 430 LBR Liberian Dollar 430 LRD 2 Libya Arab Jamahiriya 434 LBY Libyan Dinar 434 LYD 3 Liechtenstein 438 LIE Swiss Franc 756 CHF 2

37 Country/Region Name Numeric Alpha Currency Name Numeric Alpha Decimal Digit Lithuania 440 LTU Lithuanian Litas 440 LTL 2 Luxembourg 442 LUX Euro 978 EUR 2 Macau 446 MAC Pataca 446 MOP 2 Macedonia 807 MKD Denar 807 MKD 2 Madagascar 450 MDG Malagasy Ariary 969 MGA 2 Malawi 454 MWI Kwacha 454 MWK 2 Malaysia 458 MYS Malaysian Ringgit 458 MYR 2 Maldives 462 MDV Rufiyaa 462 MVR 2 Mali 466 MLI CFA Franc BCEAO 952 XOF 0 Malta 470 MLT Euro 978 EUR 2 Marshall Islands 584 MHL U.S. Dollar 840 USD 2 Martinique 474 MTQ Euro 978 EUR 2 Mauritania 478 MRT Ouguiya 478 MRO 2 Mauritius 480 MUS Mauritius Rupee 480 MUR 2 Mexico 484 MEX Mexican Peso 484 MXN 2 Micronesia 583 FSM U.S. Dollar 840 USD 2 Midway Islands 488 MID U.S. Dollar 840 USD 2 Moldova, Republic of 498 MDA Moldovan Leu 498 MDL 2 Monaco 492 MCO Euro 978 EUR 2 Mongolia 496 MNG Tugrik 496 MNT 2 Montenegro 499 MNE Euro 978 EUR 2 Montserrat 500 MSR East Caribbean Dollar 951 XCD 2 Morocco 504 MAR Moroccan Dirham 504 MAD 2 Mozambique 508 MOZ Metical 943 MZN 2 Myanmar 104 MMR Kyat 104 MMK 2 Namibia 516 NAM Dollar 516 NAD 2 Nauru 520 NRU South African Rand 710 ZAR 2 Nauru 520 NRU Australian Dollar 036 AUD 2 Nepal 524 NPL Nepalese Rupee 524 NPR 2 Netherlands 528 NLD Euro 978 EUR 2 Netherlands Antilles 530 ANT Netherlands Antillian Guilder 532 ANG 2 New Caledonia 540 NCL CFP Franc 953 XPF 0 New Zealand 554 NZL New Zealand Dollar 554 NZD 2 Nicaragua 558 NIC Cordoba Oro 558 NIO 2 Niger 562 NER CFA Franc BCEAO 952 XOF 0 Nigeria 566 NGA Naira 566 NGN 2 Norfolk Island 574 NFK Australian Dollar 036 AUD 2

38 Country/Region Name Numeric Alpha Currency Name Numeric Alpha Decimal Digit Northern Mariana Islands 580 MNP U.S. Dollar 840 USD 2 Norway 578 NOR Norwegian Krone 578 NOK 2 Oman 512 OMN Rial Omani 512 OMR 3 Pakistan 586 PAK Pakistan Rupee 586 PKR 2 Palau 585 PLW U.S. Dollar 840 USD 2 Palestinian(Palestine) 275 PSE U.S. Dollar 840 USD 2 Panama 591 PAN Balboa 590 PAB 2 U.S. Dollar 840 USD 2 Papua New Guinea 598 PNG Kina 598 PGK 2 Paraguay 600 PRY Guarani 600 PYG 0 Peru 604 PER Nuevo Sol 604 PEN 2 Philippines 608 PHL Philippine Peso 608 PHP 2 Pitcairn 612 PCN New Zealand Dollar 554 NZD 2 Poland 616 POL Zloty 985 PLN 2 Portugal 620 PRT Euro 978 EUR 2 Puerto Rico 630 PRI U.S. Dollar 840 USD 2 Qatar 634 QAT Qatari Rial 634 QAR 2 Réunion 638 REU Euro 978 EUR 2 Romanian Leu Romania 642 ROM (new) 946 RON 2 Russian Federation 643 RUS New Ruble (Russian Ruble) 643 RUB 2 Rwanda 646 RWA Rwanda Franc 646 RWF 0 Samoa 882 WSM Tala 882 WST 2 San Marino 674 SMR Euro 978 EUR 2 Sao Tome and Principe 678 STP Dobra 678 STD 2 Saudi Arabia 682 SAU Saudi Riyal 682 SAR 2 Senegal 686 SEN CFA Franc BCEAO 952 XOF 0 Serbia and Montenegro 891 YUG Serbian Dinar 891 CSD 2 Serbia, Republic of 688 SRB Serbian Dinar 941 RSD 2 Seychelles 690 SYC Seychelles Rupee 690 SCR 2 Sierra Leone 694 SLE Leone 694 SLL 2 Singapore 702 SGP Singapore Dollar 702 SGD 2 Slovakia ( Slovak Republic) 703 SVK Euro 978 EUR 2 Slovenia 705 SVN Euro 978 EUR 2 Solomon Islands 090 SLB Solomon Islands Dollar 090 SBD 2 Somalia 706 SOM Somali Shilling 706 SOS 2

39 Country/Region Name Numeric Alpha Currency Name Numeric Alpha Decimal Digit South Africa 710 ZAF Rand 710 ZAR 2 Spain 724 ESP Euro 978 EUR 2 Sri Lanka 144 LKA Sri Lanka Rupee 144 LKR 2 St. Helena 654 SHN St. Helena Pound 654 SHP 2 St. Kitts-Nevis 659 KNA East Caribbean Dollar 951 XCD 2 St. Lucia 662 LCA East Caribbean Dollar 951 XCD 2 St. Pierre and Miquelon 666 SPM Euro 978 EUR 2 St. Vincent and the East Caribbean 670 VCT Grenandines Dollar 951 XCD 2 Sudan 736 SDN Sudanese Pound 938 SDG 2 Suriname 740 SUR Surinam Dollar 968 SRD 2 Svalbard and Jan Mayen Islands 744 SJM Norwegian Krone 578 NOK 2 Swaziland 748 SWZ Lilangeni 748 SZL 2 Sweden 752 SWE Swedish Krona 752 SEK 2 Switzerland 756 CHE Swiss Franc 756 CHF 2 Syrian Arab Republic 760 SYR Syrian Pound 760 SYP 2 Taiwan 158 TWN New Taiwan Dollar 901 TWD 2 Tajikistan 762 TJK Somoni 972 TJS 2 Tanzania, United Republic of 834 TZA Tanzanian Shilling 834 TZS 2 Thailand 764 THA Baht 764 THB 2 Togo 768 TGO CFA Franc BCEAO 952 XOF 0 Tokelau 772 TKL New Zealand Dollar 554 NZD 2 Tonga 776 TON Pa anga 776 TOP 2 Trinidad and Tobago 780 TTO Trinidad and Tobago Dollar 780 TTD 2 Tunisia 788 TUN Tunisian Dinar 788 TND 3 Turkey 792 TUR New Turkish Lira 949 TRY 2 Turkmenistan 795 TKM New Manat 934 TMT 2 Turks and Caicos Islands 796 TCA U.S. Dollar 840 USD 2 Tuvalu 798 TUV Australian Dollar 036 AUD 2 U.S. Minor Outlying Islands 581 UMI U.S. Dollar 840 USD 2 Uganda 800 UGA Uganda Shilling 800 UGX 2 Ukraine 804 UKR Hryvnia 980 UAH 2 United Arab Emirates 784 ARE UAE Dirham 784 AED 2 United Kingdom 826 GBR Pound Sterling 826 GBP 2

40 Country/Region Name Numeric Alpha Currency Name Numeric Alpha Decimal Digit United States 840 USA U.S. Dollar 840 USD 2 Uruguay 858 URY Peso Uruguayo 858 UYU 2 Uzbekistan 860 UZB Uzbekistan Sum 860 UZS 2 Vanuatu 548 VUT Vatu 548 VUV 0 Holy See (Vatican City State) 336 VAT Euro 978 EUR 2 Venezuela 862 VEN Bolivar Fuerte 937 VEF 2 Vietnam 704 VNM Dong 704 VND 2 Virgin Islands, British 092 VGB U.S. Dollar 840 USD 2 Virgin Islands, U.S. 850 VIR U.S. Dollar 840 USD 2 Wake Island 872 WAK U.S. Dollar 840 USD 2 Wallis and Futuna Islands 876 WLF CFP Franc 953 XPF 0 Western Sahara 732 ESH Moroccan Dirham 504 MAD 2 Yemen 887 YEM Yemen Rial 886 YER 2 Zambia 894 ZMB Kwacha 894 ZMK 2 Zimbabwe 716 ZWE Zimbabwe Dollar 932 ZWL 2