支付网关商户开发指南-Java版V6 1.docVIP

编号： 上海浦东发展银行 支付网关 商户安装和使用指南 （JAVA版） V6.1 06/06/2007 文档修改记录 版本 日期 说明 编写者 审核者 1.0 2005-1-17 形成初稿 张国强 1.1 2005-3-10 更新接口说明 李霁伦 2.0 2005-4-28 更新接口说明、更新开发指引 李霁伦 2.1 2005-5-23 更新jks使用说明 李霁伦 3.0 2005-6-6 更新部分说明 李霁伦 4.0 2005-12-12 交易格式及对帐文件增加部分字段 李霁伦 4.1 2006-1-1 新增联机查询和新类别文件下载 李霁伦 4.2 2006-2-5 修正OsttDate字段 李霁伦 5.0 2006-2-10 新增批量查询功能 李霁伦 5.2 2006-3-15 新增公司订单相关返回功能，增强批量订单查询条件 李霁伦 6.0 2006-7-2 新增协议支付系列交易 李霁伦 6.1 2007-6-6 多笔查询功能接口优化 李霁伦 说明:本文档中所包含的信息属于机密信息，如无上海浦东发展银行书面许可，任何人都无权复制或利用。目 录 1 概述 1 1.1 文档说明 1 1.2 版本 1 1.3 阅读对象 1 2 系统概述 2 2.1 相关定义 2 2.2 支付流程简述 4 2.3 撤销、退货、查询及对帐文件下载流程 5 2.4 对帐文件格式 5 2.5 安全控制 6 3 开发准备 6 3.1 环境要求 6 3.2 开发包文件清单 6 3.3 商户支付网关证书安装步骤 7 3.3.1 说明 7 3.3.2 准备工作 7 3.3.3 获得证书 8 3.3.4 商户私钥容器文件－“spdbmerchant.jks” 8 3.3.5 商户容器属性文件—“spdb_perties” 10 3.3.6 将密钥导入商户私钥容器文件 － “spdbmerchant.jks” 10 3.3.7 更换密钥容器的密码 12 3.3.8 上传商户证书 14 3.3.9 将商户证书通过网上银行安全传递给银行 16 4 签名及验签开发指引 16 4.1 软件包接口说明 16 4.1.1 签名 16 4.1.2 验证 16 4.2 签名及验签的调用 16 4.2.1 签名方法调用 17 4.2.2 验签方法调用 18 4.3 应用部署 18 5 交易接口描述 19 5.1 基本交易要素 19 5.1.1 输入要素 19 5.1.2 输出要素 19 5.2 https页面方式交易方式 20 5.2.1 https页面交易接口 20 5.2.2 支付撤销退货 21 5.2.3 单笔查询 27 5.2.4 多笔查询 28 5.2.5 下载对帐文件 29 5.2.6 对公订单相关返回信息 30 5.2.7 对公商户撤单 31 5.2.8 协议支付签约（对私） 31 5.2.9 协议支付签约撤销（对私） 32 5.2.10 协议支付（对私） 33 5.3 https指令方式交易方式 35 5.3.1 https指令交易接口 35 5.3.2 撤销退货 36 5.3.3 单笔查询 42 5.3.4 多笔查询 43 5.3.5 下载对帐文件 45 5.3.6 对公订单相关返回信息 46 5.3.7 对公商户撤单 47 5.3.8 协议支付（对私） 47 6 上线步骤 50 6.1 签订业务协议 50 6.2 开户 50 6.3 开通公司网银 50 6.4 申请并下载公司网银证书 50 6.5 开通支付网关 50 6.6 申请并下载支付网关证书 50 6.7 上传网关证书 50 6.8 配置签名服务 50 6.9 配置URL 51 6.10 试运行 51 7 附录－常用取值 52 7.1 表2－1（网关支持的交易方式） 52 7.2 表5－2（transName域的不同取值） 52 7.3 表5－3（支付撤销退货商户输入字段） 53 7.4 表5－4（支付撤销退货输出字段） 53 7.5 表5－5（TranAbbr域的不同取值） 54 7.6 表5－6（RespCode域的不同取值） 54 7.7 表5－7（单笔查询商户输入） 58 7.8 表5－8（查询输出） 58 7.9 表5－9（多笔查询输入） 59 7.10 表5－10（对帐下载商户输入） 59 7.11 表5－11（对公商户撤单输出） 59 7.12 表5－12（协议支付签约输入） 60 7.13 表5－13（协议支付签约输出） 61 7.14 表5－14（协议支付签约撤销输入） 61 7.15 表5－15（协议支付签约撤销输出） 61 7.16 表5－16（协议支付输入） 62 概述 文档说明 电子商务支付中，商户是进行商品售出的一方