Android--微信支付
目录
微信支付
1
一、
创建应用
2
二、
支付集成
5
1
、
body
字段格式
8
三、
参考网址
12
四、
Android Studio
的两种模式及签名配置
12
一、
创建应用
1>
登陆微信开放平台(
https://open.weixin.qq.com/cgi-bin/index?t=home/index&lang=zh_CN&token=024e5186b4199c44bcc6711f789a52f43fcaff23
)
进入管理中心，
2>
管理中心
/
创建移动应用
图片按要求上传，否则，上传不上去，上传的图片最好清晰
创建应用时
应用官网
要正确
之后就等提交审核了，一般在三到四天之内有消息
应用签名的生成方法：
(1)
下载应用签名工具：
签名工具下载地址
https://open.weixin.qq.com/zh_CN/htmledition/res/dev/download/sdk/Gen_Signature_Android.apk
下载下来
不要解压，更改文件后缀名为.apk
然后安装到手机就行了
(2)
签名工具作用：
根据项目的应用包名和编译使用的
keystore
，可由签名工具生成一个
32
位的
md5
串，在调试的手机上安装签名工具后，运行可生成应用签名串，绿色串即应用签名。
(3)
不要着急着生成签名:
先打包生成release.apk 将
release.apk
安装到手机 然后再用签名工具生成 签名
(4)
怎么生成release版本：
参考地址
http://www.cnblogs.com/details-666/p/keystore.html
(5)
(6)
这里没设置好的话，后面支付会出现问题，具体问题后面再说
3>
管理中心\应用详情
申请开通
不过这已经是审核通过后的事情了，
所以当确定应用有这个功能的时候，应用网址也存在，那么就需要及时申请，不然等到做到这个模块再申请，那调试也就必须等着了
4>
应用审核过后，申请开通支付功能（这里面会支付给微信300大洋），开通后会给商户账户 支付的时候用到的信息就有 商户号 微信分配的公众账号
ID API
密钥，在商户平台设置
商户在微信公众平台
(
申请扫码支付、公众号支付
)
或开放平台
(
申请
APP
支付
)
按照相应提示，申请相应微信支付模式。微信支付工作人员审核资料无误后开通相应的微信支付权限。微信支付申请审核通过后，商户在申请资料填写的邮箱中收取到由微信支付小助手发送的邮件，此邮件包含开发时需要使用的支付账户信息
| 邮件中参数 | API参数名 | 详细说明 |
| APPID | appid | appid是微信公众账号或开放平台APP的唯一标识，在公众平台申请公众账号或者在开放平台申请APP账号后，微信会自动分配对应的appid，用于标识该应用。可在微信公众平台-->开发者中心查看，商户的微信支付审核通过邮件中也会包含该字段值。 |
| 微信支付商户号 | mch_id | 商户申请微信支付后，由微信支付分配的商户收款账号。 |
| API密钥 | key | 交易过程生成签名的密钥，仅保留在商户系统和微信支付后台，不会在网络中传播。商户妥善保管该Key，切勿在网络中传输，不能在其他客户端中存储，保证key不会被泄漏。商户可根据邮件提示登录微信商户平台进行设置。也可按一下路径设置：微信商户平台(pay.weixin.qq.com)-->账户设置-->API安全-->密钥设置 |
| Appsecret | secret | AppSecret是APPID对应的接口密码，用于获取接口调用凭证access_token时使用。 |
二、
支付集成
1.
支付（业务）流程图解
以下是交互时序图，统一下单
API
、支付结果通知
API
和查询订单
API
等都涉及签名过程，调用都必须在商户服务器端完成。如图所示。
图
8.6 APP
支付时序图
商户系统和微信支付系统主要交互说明：
步骤
1
：用户在商户
APP
中选择商品，提交订单，选择微信支付。
步骤
2
：商户后台收到用户支付单，调用微信支付统一下单接口。参见【
统一下单
API
】。
步骤
3
：统一下单接口返回正常的
prepay_id
，再按签名规范重新生成签名后，将数据传输给
APP
。参与签名的字段名为
appid
，
partnerid
，
prepayid
，
noncestr
，
timestamp
，
package
。注意：
package
的值格式为
Sign=WXPay
（
ios必须是这个
）
步骤
4
：商户
APP
调起微信支付。
api
参见本章节【
app
端开发步骤说明
】
步骤
5
：商户后台接收支付通知。
api
参见【
支付结果通知
API
】
步骤
6
：商户后台查询支付结果。，
api
参见【
查询订单
API
】
2.
微信支付文档查看
https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=8_3
2.1
支付中术语
支付模式（这里我们要用到app支付）
1
、
刷卡支付
刷卡支付是用户展示微信钱包内的
“
刷卡条码
/
二维码
”
给商户系统扫描后直接完成支付的模式。主要应用线下面对面收银的场景。
2
、
扫码支付
扫码支付是商户系统按微信支付协议生成支付二维码，用户再用微信
“
扫一扫
”
完成支付的模式。该模式适用于
PC
网站支付、实体店单品或订单支付、媒体广告支付等场景。
3
、
公众号支付
公众号支付是用户在微信中打开商户的
H5
页面，商户在
H5
页面通过调用微信支付提供的
JSAPI
接口调起微信支付模块完成支付。应用场景有：
◆
用户在微信公众账号内进入商家公众号，打开某个主页面，完成支付
◆
用户的好友在朋友圈、聊天窗口等分享商家页面连接，用户点击链接打开商家页面，完成支付
◆
将商户页面转换成二维码，用户扫描二维码后在微信浏览器中打开页面后完成支付
4
、
APP
支付
APP
支付又称移动端支付，是商户通过在移动端应用
APP
中集成开放
SDK
调起微信支付模块完成支付的模式。
名词解释
1
、微信公众平台
微信公众平台是微信公众账号申请入口和管理后台。商户可以在公众平台提交基本资料、业务资料、财务资料申请开通微信支付功能。
平台入口：
http://mp.weixin.qq.com
。
2
、微信开放平台
微信开放平台是商户
APP
接入微信支付开放接口的申请入口，通过此平台可申请微信
APP
支付。
平台入口：
http://open.weixin.qq.com
。
3
、微信商户平台
微信商户平台是微信支付相关的商户功能集合，包括参数配置、支付数据查询与统计、在线退款、代金券或立减优惠运营等功能。
平台入口：
http://pay.weixin.qq.com
。
4
、微信支付系统
微信支付系统是指完成微信支付流程中涉及的
API
接口、后台业务处理系统、账务系统、回调通知等系统的总称。
5
、商户收银系统
商户收银系统即商户的
POS
收银系统，是录入商品信息、生成订单、客户支付、打印小票等功能的系统。接入微信支付功能主要涉及到
POS
软件系统的开发和测试，所以在下文中提到的商户收银系统特指
POS
收银软件系统。
6
、商户后台系统
商户后台系统是商户后台处理业务系统的总称，例如：商户网站、收银系统、进销存系统、发货系统、客服系统等。
7
、商户证书
商户证书是微信提供的二进制文件，商户系统发起与微信支付后台服务器通信请求的时候，作为微信支付后台识别商户真实身份的凭据。
8
、签名
商户后台和微信支付后台根据相同的密钥和算法生成一个结果，用于校验双方身份合法性。签名的算法由微信支付制定并公开，常用的签名方式有：
MD5
、
SHA1
、
SHA256
、
HMAC
等。（一般用MD5）
9
、支付密码
支付密码是用户开通微信支付时单独设置的密码，用于确认支付完成交易授权。该密码与微信登录密码不同。
10
、
Openid
用户的身份标识，不同应用拥有不同的
openid
。商户后台系统通过登录授权、支付通知、查询订单等
API
可获取到用户的
openid
。主要用途是判断同一个用户，如果商户有公众号，可以通过获取
unionid
判断同一个用户。
2.2
接口规则
协议规则
商户接入微信支付，调用
API
必须遵循以下规则：
| 传输方式 | 为保证交易安全性，采用HTTPS传输 |
| 提交方式 | 采用POST方法提交 |
| 数据格式 | 提交和返回数据都为XML格式，根节点名为xml |
| 字符编码 | 统一采用UTF-8字符编码 |
| 签名算法 | MD5，后续会兼容SHA1、SHA256、HMAC等。 |
| 签名要求 | 请求和接收数据均需要校验签名，详细方法请参考安全规范-签名算法 |
| 证书要求 | 调用申请退款、撤销订单接口需要商户证书 |
| 判断逻辑 | 先判断协议字段返回，再判断业务返回，最后判断交易状态 |
参数规则
1
、
body
字段格式
| 使用场景 | 支付模式 | 商品字段规则 | 样例 | 备注 |
| 第三方APP | APP支付 | 应用市场上的APP名字-商品概述 | 天天爱消除-游戏充值 |
2
、交易金额
交易金额默认为人民币交易，接口中参数支付金额单位为【分】，参数值不能带小数。对账单中的交易金额单位为【元】。
外币交易的支付金额精确到币种的最小单位，参数值不能带小数点。
3
、交易类型
JSAPI--
公众号支付、
NATIVE--
原生扫码支付、
APP--app
支付，统一下单接口
trade_type
的传参可参考这里
MICROPAY--
刷卡支付，刷卡支付有单独的支付接口，不调用统一下单接口
4
、货币类型
货币类型的取值列表：
CNY
：人民币
5
、时间
标准北京时间，时区为东八区；如果商户的系统时间为非标准北京时间。参数值必须根据商户系统所在时区先换算成标准北京时间，
例如商户所在地为
0
时区的伦敦，当地时间为
2014
年
11
月
11
日
0
时
0
分
0
秒，换算成北京时间为
2014
年
11
月
11
日
8
时
0
分
0
秒。
6
、时间戳
标准北京时间，时区为东八区，自
1970
年
1
月
1
日
0
点
0
分
0
秒以来的秒数。注意：部分系统取到的值为毫秒级，需要转换成秒
(10
位数字
)
。
7
、商户订单号
商户支付的订单号由商户自定义生成，微信支付要求商户订单号保持唯一性（建议根据当前系统时间加随机序列来生成订单号）。重新发起一笔支付要使用原订单号，避免重复支付；已支付过或已调用关单、撤销（请见后文的
API
列表）的订单号不能重新发起支付。
8
、银行类型
安全规范
https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=4_3
1、
签名算法
2、
生成随机数算法
3、
商户证书
4、
商户回调
API
安全
2.3
APP支付页面规范示例
◆列表首位
+
默认勾选
+
标准
logo+
推荐标签
+
标语
◆素材下载
微信支付
logo
、
APP
支付素材下载
2.4
Android微信支付
demo
下载
https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419319167&token=&lang=zh_CN
下载后的demo是
eclipse
版的，请求极其不规范，所有请求都放到了主线程中，所以大家可以下载另一个
demo
http://download.csdn.net/detail/simon_crystin/9699743
3.
集成
3.1
依赖
在app下的
build.gradle
里到如依赖
dependencies {
compile 'com.tencent.mm.opensdk:wechat-sdk-android-with-mta:+'
compile 'cz.msebera.android:httpclient:4.4.1.2'
}
3.2
导入需要的工具类
这些类的作用
1.
wxapi中的
WXPayEntryActivity
是支付时会调用的类，这里
类名和包名均不能改变
2.
Constants存放商户
ID,AppID,Api_key
3.
MainActivity执行的是提交订单（
demo
中做了服务器的工作）
4.
MD5 ，
MD5Util
签名工具，微信支付请求中
sign
是通过
MD5
签名的 看算法
5.
Util是请求类，主要是用
httpClient
请求的
3.3 AndroidManifest
.xml配置
1．
权限
2．
注册类和receiver
android
:name=
"com.ssmk.wxapi.WXEntryActivity"
android
:exported=
"true"
android
:label=
"@string/app_name"
android
:launchMode=
"singleTop"
>
//添加自己的
AppId
android
:name=
"com.ssmk.wxapi.WXPayEntryActivity"
android
:exported=
"true"
android
:launchMode=
"singleTop"
/>
//也没必要
//支付类
3.4
类的作用
IWXAPI api类 创建方式
IWXAPI msgApi = WXAPIFactory.createWXAPI(this, null);
注册app msgApi.registerApp(
“
AppID
”
);
PayReq 请求支付类 创建
PayReq req=new PayReq();
拼接参数
req.appId = Constants.APP_ID;
req.partnerId = Constants.MCH_ID;
req.prepayId = resultunifiedorder.get("prepay_id");
req.packageValue = "Sign=WXPay";
req.nonceStr = getNonceStr();
req.timeStamp = String.valueOf(genTimeStamp());
List signParams = new LinkedList()
;
signParams.add(new BasicNameValuePair("appid", req.appId));
signParams.add(new BasicNameValuePair("noncestr", req.nonceStr));
signParams.add(new BasicNameValuePair("package", req.packageValue));
signParams.add(new BasicNameValuePair("partnerid", req.partnerId));
signParams.add(new BasicNameValuePair("prepayid", req.prepayId));
signParams.add(new BasicNameValuePair("timestamp", req.timeStamp));
req.sign = genAppSign(signParams);
请求支付 msgApi.sendReq(req);
BaseResp 请求支付后，回调到支付完成类（完成并不代表支付成功）（在
wxapi
包下
WXPayEntryActivity
的
@Override
public void onResp(BaseResp resp) {
resp.errCode//
返回结果
名称 描述 解决方案
0 成功 展示成功页面
-1 错误 可能的原因：签名错误、未注册
APPID
、项目设置
APPID
不正确、注册的
APPID
与设置的不匹配、其他异常等。
-2 用户取消 无需处理。发生场景：用户不支付了，点击取消，返回
APP
。
resp.getType() == ConstantsAPI.COMMAND_PAY_BY_WX
返回类型
）
三、
参考网址
https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419319167&token=&lang=zh_CN
（官网）
http://blog.csdn.net/simon_crystin/article/details/53433504
(微信支付详解和
Demo)
http://blog.csdn.net/hello_1s/article/details/52636447
(支付的坑
)
http://blog.csdn.net/gf771115/article/details/71104143
(详解
)
http://www.jianshu.com/p/09e37fb42f7e
四、
Android Studio
的两种模式及签名配置
我们使用
Android
Studio
运行我们的
app
，无非两种模式：
debug
和
release
模式。
debug
模式
debug
模式使用一个默认的
debug.keystore
进行签名。
这个默认签名
(keystore)
是不需要密码的，它的默认位置在
C:\Users\<
用户名
>\.
Android
\debug.keystore
，如果不存在
Android studio
会自动创建它。
例如我的
debug.keystore
就在
C:\Users\Administrator\.android\debug.keystore
。
release
模式
在我们正式发布项目的时候是不能使用
debug.keystore
的。开发过程中我们也可以使用发布模式运行。可以通过如下设置：
BuildVariants-Build Variant-debug/release
如果项目需要细分开发
dev
和生产
pro
版本，每个版本中都包含
debug
和
release
模式，可以这么设置：
就细分成四种模式：
release
模式
需要配置签名才能运行，这时
就需要一个
keystore
如果没有就需要创建，已经创建过
keystore
请跳过此步骤
1.
创建
keystore
，并生成我们的
apk(
打包
)
第一步：
Build --->> Generate Signed APK
第二步：
Create New···
（
已经创建过
keystore
选
Choose existing···
）
第三步：填写相关信息
设置
keystore
路径、密码，设置
key
：别名、密码、有效期，证书等
Key store path:
存放路径
Key
Alias:
别名
Validity(years):
有效期（一般默认
25
年）
Certificate:
证书
First and Last Name
：姓名
Organization Unit
：组织单位
Organization
：组织
City or Locality
：城市或地区
State or Province
：州或省
Country Code(XX)
：国家代码
(XX)
，中国：
86
第四步：输入
key
、
keystore
密码
第五步：选择发布
app
的路径，默认即可 选择
release
方式发布
OK
，发布成功，可以到 刚才设置的目标文件夹下面找到发布的
apk
那对一些人来说，这样也太麻烦了，每次都得输入相关信息，还得进行选择，那么有更简单快捷的方法吗？答案是有的。
我们可以在项目的
app
目录下的
build.gradle
中进行签名的配置。
2.release
模式配置
keystore
Project structure-signing,
输入已创建的
keystore
信息
使得签名生效需配置
Build Types
点击
OK
即可，然后查看对应
build.gradle
的配置文件应该是这样的。当然了，你也可以通过直接在
build.gradle
里面写下面这段。
1
signingConfigs {
2
release {
3
keyAlias
'androiddebugkey'
4
keyPassword
'android'
5
storeFile file(
'C:/Users/ssc/.android/debug.keystore'
)
6
storePassword
'android'
7
}
8
}
9
10
·········
11
12
buildTypes {
13
release {
//
是否混淆
14
minifyEnabled
false
//
是否移除无用资源
15
zipAlignEnabled true
//
混淆的配置文件
16
proguardFiles getDefaultProguardFile(
'proguard-android.txt'
),
'proguard-rules.pro'
17
signingConfig signingConfigs.release
18
}
19
}
上述的配置虽然配置简单，但是存在不安全性，假如你的项目是开源的，你把签名文件的配置密码之类的信息用明文写在
build.gradle
里面，那是不是很不安全呢
?
可以将签名文件的配置密码之类的信息直接写在
local.properties
下，因为在
Git
版本控制
的项目中，我们可以看到我们项目
project
模式根目录下有一个
.gitignore
的文件，里面的配置大概如下所示
我们可以看到
/local.properties
，意思就是说
local.properties
默认是不添加到版本控制里面的，因为
local.properties
存储的是我们环境资源的一些相关信息，如
sdk
的路径。故我们可以在
local.properties
下配置签名信息而不用担心密钥外泄。对于开源项目来说，是非常好的。
在
local.properties
下直接添加相关信息
在
build.gradle
里，为了不用明文显示，我们首先要获得
key
的相关配置，所以我们可以在
app
的
build.gradle
里
android {}之上新增代码
View Code
app/build.gradle
下的
signingConfigs
可以改为：
?
| 1 2 3 4 5 6 7 8 |
signingConfigs { release { keyAlias keystoreAlias keyPassword keystoreAliasPSW storeFile keyfile storePassword keystorePSW } } |
设置后
Signing
中
keystore
值无需关心
相应的，
buildTypes
也可以配置成这样
1
buildTypes {
2
release {
3
minifyEnabled
false
4
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
5
// signingConfig signingConfigs.release
6
//
签名文件存在，则签名
7
if
(keyfile.exists()) {
8
println("WITH -> buildTypes -> release: using jks key")
9
signingConfig signingConfigs.release
10
}
else
{
11
println("WITH -> buildTypes -> release: using default key")
12
}
13
applicationVariants.all { variant ->
14
variant.outputs.each { output ->
15
def outputFile = output.outputFile
16
if
(outputFile !=
null
&& outputFile.name.endsWith('.apk')) {
17
//
输出
apk
名称为
ruijie_v1.0_wandoujia.apk
18
def fileName = "ruijie_v${defaultConfig.versionName}_${variant.productFlavors[0].name}.apk"
19
output.outputFile =
new
File(outputFile.parent, fileName)
20
}
21
}
22
}
23
}
24
}
到此，前面配置完成。
附
:
查询
keystore
的相关信息，如查看
sha1
的值；可以在运行窗口，定位到
keystore
所在的路径，执行
cd C:\Users\ssc\.android
执行这条语句后就能显示
Key
的所有信息
(
以
android
默认
keystore
为例
)
keytool -list -v -keystore xxx.jks