民生付商户端开发手册和接口规范V1.0.0.doc

中 国 民 生 银 行 民生付商户端开发手册 及接口规范 版本V1.0.0 2015年 06月24日 文档修订记录 版本号 *变化状态 简要说明 日期 变更人 批准人 批准日期 V1.0.0 C 文档创建 2015-06-24 V1.0.0 M 增加方式调整支付接口-07-02 V1.0.0 M 4.3.2应答报文 （同步）删除“remark” 2016-04-01 文档修订记录说明： *变化状态：C―创建，A—增加，M—修改，D—删除，P—发布 版本规范是：主版号.次版本号.修订号 目录 目录 ii 第1章 民生付网关支付概述 1 1.1商户申请流程 1 1.2本行卡网关支付流程 1 1.3他行卡网关支付流程 2 1.4本他行收单差异 3 第2章 商户接入方案 4 2.1PC端网关接入 4 2.2 移动端网关接入 4 2.3手机银行接入 6 第3章 加解密流程 6 3.1商户到银行的加密流程 6 3.2银行到商户的加密流程 7 第4章 网关支付接口 8 4.1网关支付 8 4.2订单查询 11 4.3订单退货 13 第5章 商户对账文件 16 5.1 对账文件概述 16 5.2 SFTP对账文件格式说明 16 第6章 附录 17 6.1 测试环境 17 6.2 短信验证码获取 17 6.3 商户服务系统 17 6.4 程序demo 18 6.5 错误码定义 18 6.6 货币代码 19 6.7 商品类型 20 第7章 常见问题 23 民生付网关支付概述 1.1商户申请流程通过分行提交民生付审批 业务审批通过，给商户发送商户接入包 在测试环境联调 商户根据两码在我行证书下载页面下载证书 客户登录商户网站，选择商品进行支付。 商户按照民生付网关支付接口标准订单将订单数据加密签名，发送到民生付支付网关网关做解密验签，客户卡民生卡，跳转民生付订单支付页面。支付页面支付方式卡支付、网银或手机银行登陆输入交易信息，进行支付操作。付支付请求后，该笔订单的处理。付将结果以后异步通知系统。付支付结果页面，可选择商户。 客户选择返回商户，结果密文以回商户页面。 选择直连方式发起订单查询和退货的。 可直连方式发起退货。 前提：商户已经申请开通民生付 1) 客户登录商户网站，选择商品进行支付。 2) 商户按照民生付网关支付接口标准组装订单，将订单数据加密签名，通过浏览器发送到民生付支付网关。 3) 民生付网关做解密验签，如果客户卡他行卡，，民生付网关处理支付结果，同时将支付结果密文以后台异步通知方式转发商户系统网关，民生付网关处理支付结果，同时将结果密文民生付网关实时将请求转发第三方 11）第三方完成退货处理后，，民生付网关处理结果，同时将结果密文以后台异步通知方式转发商户系统行收单差异方式 民生付商户默认开通收单 跨行收单需单独跟我行签订跨行收单协议，且跨行收单手续费参数需单独协商时效差异 后，退款账户 跨行退货处理周期取决于他行退货处理时间，退货成功后我行异步通知商户。 3）日终结算差异 每日零点以后，开始做本行卡的结算，生成本行卡支付的对账文件。 每日十二点以后，开始做他行卡的结算，生成他行卡支付的对账文件。他行卡支付的对账文件只包含每日与第三方已清算银行2.1PC端网关接入 通过 2.1.1接入方案： 1. 2.接入订单查询服务结果的交易，商户发起订单查询订单最终状态。 服务： 服务如果有跨行收单需求，需同时自动需我行，日终将对账文件以推送到商户指定的。可退货和对账单下载 2.1.2接入付商户接入文档根据商户端语言选择对应签名验签包。3.测试数据：本行和跨行收单选择对应的测试数据。4.直连接入SFTP对账模板接入需要业务审批在测试环境通过提供。形式的移动网关接入：APP跳转我行支付页面我行支付接入 目前移动端网关接入支持主流的移动操作系统：Android与IOS。 针对本身没有APP移动网关接入需求商户，可移动网关接入方式。方式客户支付限额方式低。方案： 1.APP方式跳转时需要。2.接入我行提供的统一网关支付服务，同时在商户端部署支付成功后的通知服务。 3.接入订单查询服务结果的交易，商户发起订单查询订单最终状态。 服务： 服务如果有跨行收单需求，需同时自动需我行，日终将对账文件以推送到商户指定的。可退货和对账单下载APP跳转网关Android的demo参考：移动端接入包（Android版）.rar IOS 的demo参考：移动端