中国邮政储蓄银行网上支付平台商户开发指南Java版V21.doc

网上支付平台 商户开发指南 （JAVA版） 中国邮政储蓄银行有限责任公司 文档修改记录 版本 日期 说明 编写 审核 1.0 2009-11-1 形成初稿 csii 陈宜 1.6 2010-3-20 更新接口说明 csii 陈宜 2.0 2010-11-1 更新商户开发包，更新文档与接口说明 csii 目录 1 概述 5 1.1 文档说明 5 1.2 版本说明 5 1.3 阅读对象 5 2 系统概述 5 2.1 定义 5 2.2 支付流程简述 6 2.3 退货、查询及对帐文件下载流程 7 2.4 对帐文件格式 8 2.5 安全控制 8 3 开发准备 8 3.1 环境要求 8 3.2 开发包文件清单 9 3.3 商户数字证书安装步骤 9 3.3.1 说明 9 3.3.2 准备工作 9 3.3.3 获得证书 10 3.3.4 商户密钥容器文件—“psbc_merchant.jks” 10 3.3.5 商户密钥容器属性文件—“psbc_perties” 12 3.3.6 将密钥导入商户密钥容器文件—“psbc_merchant.jks” 12 3.3.7 修改密钥容器的密码 14 3.3.8 导出商户证书 14 3.3.9 将商户证书通过网上银行安全传递给银行 16 3.4 商户数字证书私钥更新步骤 16 3.4.1 删除旧的商户数字签名证书 16 3.4.2 导入新的商户数字签名证书 17 3.4.3 上传商户证书 17 3.5 银行支付平台证书更新步骤 17 3.5.1 删除银行支付平台证书 17 3.5.2 导入银行支付平台证书 17 4 签名及验签开发指引 18 4.1 软件包接口说明 18 4.1.1 签名方法 18 4.1.2 验签方法 19 4.2 签名及验签的调用 19 4.3 应用部署 19 5 交易接口描述 19 5.1 基本交易要素 20 5.1.1 输入要素 20 5.1.2 交易提交URL 21 5.2 交易方式 22 5.2.1 如何编写https页面交易接口 22 5.2.2 如何编写https指令交易接口 23 5.3 交易说明 24 5.3.1 支付交易（IPER） 24 5.3.2 退货交易（IPSR） 26 5.3.3 单笔查询（IQSR） 27 5.3.4 多笔查询（BQSR） 28 5.3.5 下载对帐文件（IDFR） 30 6 上线步骤 32 6.1 签订业务协议 32 6.2 开户 32 6.3 开通公司网银 32 6.4 申请并下载公司网银证书 32 6.5 开通银行支付平台 32 6.6 申请并下载银行支付平台证书 32 6.7 配置数字证书 33 6.8 上传商户证书 33 6.9 配置生产环境URL 33 6.10 试运行 33 7 商户管理系统使用说明 34 7.1 登录商户管理系统 34 7.2 商户端证书公钥的上传 36 7.3 支付功能的开通/关闭 36 7.4 关联账户余额查询 36 7.5 关联账户明细查询 37 7.6 支付交易查询 38 7.7 对账文件下载 38 7.8 单笔退货 39 7.9 批量退货 39 7.10 批量退货结果文件下载 40 8 结算说明 40  概述 文档说明 网上支付业务中，商户是进行商品售出的一方，客户是进行商品购买和货款支付的一方，邮政储蓄银行支付平台是为客户的购买行为进行支付的一方，以下简称银行支付平台。商户连接客户和银行支付平台。在和银行支付平台进行连接时，由银行支付平台一方提供数据的加密传输和身份验证的接口程序。 银行支付平台接收商户送来的订单信息后进行处理，支付交易处理完毕后将结果返回给商户网站。同时提供多种方式供商户进行退货、查询订单支付状态以及下载对帐文件等功能。 本操作手册用来指导商户技术人员来实现与中国邮政储蓄银行支付平台的顺利连接。请相关技术人员详细阅读本手册。 版本说明 根据商户平台和应用技术的不同，商户端接口方式分成JAVA 版、.Net版，本文档是JAVA版。 阅读对象 商户开发人员 中国邮政储蓄银行支付平台相关技术人员 系统概述 定义 “客户”是指网上支付过程中的付款方，分为“个人客户”和“公司客户”。通常，使用“卡”/“折”支付的客户是“个人客户”，使用公司帐户支付的是“公司客户”。（目前银行支付平台仅支持个人客户支付） “商户”是指网上支付过程中的收款方，商户需要向我行相关部门申请后获得商户身份，完成商户开户后会分配商户号给该商户，由于借记卡与信用卡的手续费费率有所不同，我行会分配给商户两个商户号，一个商户号用于支持信用卡账户支付，一个商户号用于支持储蓄账户支付，即：如果某商户的客户既有储蓄账户支付又支持信用卡账户支付，就必