国付宝移动支付Android接入文档V2.2.docx

国付宝移动支付Android插件接入文档［V2.2］国付宝信息科技有限公司Gopay Information Technology Company, limited日期版本说明作者2015-3-181.0初稿魏雅军2016-3-222.1mobileToken修改刘张朋目录前言3目标3阅读对象3术语定义3接入流程3商户接入准备3交易流程示意图4交易流程5商户测试上线流程5使用说明5支付插件接入使用说明5商户传送参数列表8返回商户参数列表10加密域生成12signValue加密域字段12加密算法13关于商户识别码(VerficationCode）13通知机制14联系我们15公司相关信息15联系方式15测试环境测试资源15前言目标本文档旨在介绍说明国付宝新平台移动支付Android端接入插件及其使用方法，以达到帮助商户App开发过程中便捷地接入国付宝移动支付流程的目的。阅读对象本文档的阅读对象是接入商户的应用开发人员。术语定义缩写/术语解释Android安卓智能手机操作系统App手机应用程序，Application的缩写JARJAR（Java Archive，Java 归档文件）是与平台无关的文件格式，它允许将许多文件组合成一个压缩文件。为 J2EE 应用程序创建的 JAR 文件是 EAR 文件（企业 JAR 文件）接入流程商户接入准备商户在国付宝网站注册企业用户，并收取系统邮件进行激活。商户以邮寄、传真等方式将营业执照等复印件送国付宝运营平台审核，审核通过后商户可使用注册的email地址作为用户名登录国付宝。登录后首先开通企业结算虚拟帐户并设置支付密码。点击页面右上角的“开通商户服务”链接，并输入真实有效的商户申请信息，提交后等待国付宝运营人员审核。审核通过后请退出并重新登录商户企业用户，开通商户服务的企业用户将新增（商城\商铺服务）功能，并在安全中心功能中增加“设置识别码”功能，商户自行输入识别码后即可生效。关于识别码详见关于商户识别码。交易流程示意图交易流程买家在商户应用系统选择商品，商户生成订单并调用国付宝移动支付插件，形成一笔支付请求。国付宝移动支付插件将请求发送到国付宝网关，网关对报文进行校验，然后进行相应的账务处理。支付流程结束，网关处理完毕后，将处理结果报文(返回参数见返回商户参数列表)通知到商户上送的服务器通知地址，具体通知机制见通知机制。商户测试上线流程商户接入国付宝测试环境进行联调测试。商户接入国付宝正式环境进行联调测试。正式上线运营。使用说明 支付插件接收到传递过来的数据后会将请求数据发送到网关服务器，等待网关的校验和响应，通过校验则会在支付插件主界面开始具体的支付流程，校验不通过根据服务器返回提示支付失败页面。支付插件接入使用说明商户App接入国付宝新平台移动支付Android插件，将国付宝提供的GopayMobilepayByWa.jar包导入到工程libs文件夹中。在AndroidManifest.xml中定义activity android:name=com.gopay.mobilepaybygopay_wap.GopayByWap /activityactivity android:name=com.gopay.mobilepaybygopay_wap.GopayTools /activityuses-permission android:name=android.permission.INTERNET / uses-permission android:name=android.permission.WRITE_EXTERNAL_STORAGE/ uses-permission android:name=android.permission.MOUNT_UNMOUNT_FILESYSTEMS/。完成以上步骤后，在需要跳转插件的页面添加代码，import com.gopay.mobilepaybygopay_wap.GopayByWap;.并调用Intent i = new Intent(MainActivity.this, GopayByWap.class);Bundle bundle = new Bundle();bundle.putSerializable(AuthInfo, authInfo);i.putExtras(bundle);startActivity(i);;方法来发起国付宝移动支付流程，商户App跳转至国付宝移动支付插件前，首先需要将提交的报文数据（见商户传递参数列表）以键值对存入一个HashMapString, String ;中传入参数parameters。调用示例： HashMapString, String authInfo = new HashMapString,