支付宝快捷支付教程:
1. 开发前准备:
1.下载集成开发包
下载地址: https://b.alipay.com/order/productDetail.htm?productId=2013080604609654这个开发包包含了开发的详细指导,包括私钥公钥生成,接口文档,服务端开发例子,客户端开发例子等诸多说明。详细如图所示:
2. 申请支付宝快捷支付服务
申请地址: https://b.alipay.com/order/productDetail.htm?productId=2013080604609654我们要使用支付宝的快捷支付功能,必须先去支付宝进行申请,与支付宝达成合约之后,它会为我们(商家)分配一个PID(partnerID)和安全检验码,其中PID有用到,安全检验码则未用到。详细如图所示:
3. 生成私钥,交换公钥
生成私钥公钥步骤:打开下载下来文件夹,进入到openssl文件夹下的bin目录(F:\download\WS_SECURE_PAY_SDK\openssl\bin),双击openssl.exe将会打开dos命令窗口,依次执行3个命令:
①,执行:openssl genrsa -out rsa_private_key.pem 1024
②再执行:openssl rsa -in rsa_private_key.pem -pubout -out rsa_public_key.pem
③最后执行,将RSA私钥转换成 PKCS8 格式:openssl pkcs8 -topk8 -inform PEM -in rsa_private_key.pem -outform PEM -nocrypt
执行完之后,将会生成rsa_private_key.pem文件和rsa_public_key.pem文件,用记事本打开这两个文件,这就是我们客户端生成的私钥和公钥,
私钥我们自己保留,公钥则需要去与支付宝互换; 为什么要互换公钥,那是因为
商户在使用RSA签名方式的支付宝接口时,真正会用到的密钥是商户私钥与支付宝公钥。商户上传公钥给支付宝,支付宝把公钥给商户,是公钥互换的操作。
这就使得商户使用自己的私钥做签名时,支付宝端会根据商户上传的公钥做验证签名。同理,当支付宝返回数据给我们时,我们也可以用他之前换给我们的公钥进行签名验证。
2. 开发环境的搭建:
在下载下来的开发教程中,有两个项目alipay_lib和alipay_sdk_demo,后者是我们做开发需要更改的demo例子,前者是快捷支付所依赖的LibraryProject。打开eclipse,导入工程alipay_lib,并勾选asLibrary;再导入alipay_sdk_demo工程,在alipay_sdk_demo项目中加入alipay.jar(放在libs目录下),然后将之前导入的alipay_lib工程作为library引进来。
3. 具体代码开发:
我们先看看项目的布局,图工程1.png;
keys.java里面都是些我们需要的变量的定义,ExternalPartner.java则是具体逻辑的实现类。
其实使用支付宝的快捷支付接口很简单,就是按照它定义好的接口准备参数,调用Alipay.pay(String param)即可,
Alipay 接口主要为商户提供快捷登录、订单支付等功能。至于怎么准备参数,我们接着往下看。
客户端要生成一个订单需要如下参数
service="mobile.securitypay.pay"//接口名称,是一个固定值,不可控
partner="2088101568358171" //合作者身份ID,即我们申请得到的PID,以2088开头的16位纯数字,不可空
_input_charset="utf-8"//参数编码字符集,商户网站使用的编码格式,固定为utf-8,不可空
out_trade_no="0819145412-6177"//商户网站唯一订单号,注意,这个是客户端传给支付宝的,只需要保证在商户网站的唯一性即可,不可误以为是支付宝交易单号,不可空
subject="阿迪达斯"//商品名称,可以是商品的标题/ 交易标题/ 订单标题/ 订单关键字等。该参数最长为128 个汉字。不可空
payment_type="1"//支付类型,默认值为:1(商品购买)。不可空
seller_id="xiaoming@qq.com"//卖家支付宝账号,可以是邮箱或手机号码格式或其对应的支付宝唯一用户号(以 2088开头的纯16位数字)。 不可空
total_fee="100"//订单总金额单位为RMB-Yuan 。取值范围为[0.01,100000000.00] ,精确到小数点后两位。不可空
body="阿迪达斯上衣"//商品详情,对一笔交易的具体描述信息。不可空
sign_type="RSA"//签名方式,目前仅支持 RSA。 不可空
sign="lBBK%2F0w5LOajrMrji7DUgEqNjIhQbidR13GovA5r3TgIbNqv231yC1NksLdw%2Ba3JnfHXoXuet6XNNHtn7VE%2BeCoRO1O%2BR1KugLrQEZMtG5jmJIe2pbjm%2F3kb%2FuGkpG%2BwYQYI51%2BhA3YBbvZHVQBYveBqK%2Bh8mUyb7GM1HxWs9k4%3D"//签名,字符串不能包含回车换行,空格等特殊字符串。不可空
appenv="system=android^version=3.0.1.2"//标识客户端来源,参数值内容约定为 appenv=”system=客户端平台名^version=业务系统版本”,可空
notify_url="http://notify.msp.hk/notify.htm"//服务器异步通知的商户页面路径,路径需要URL encode,可空。
app_id="external"//客户端号,用来标识是客户端,可空
it_b_pay="30m"//未付款交易的超时时间,一旦超时,该笔交易就会自动被关闭。取值范围:1m~15d 。m-分钟,h- 小时,d- 天,1c-当天(无论交易何时创建,都在0 点关闭)。 该参数数值不接受小数点,如1.5h ,可转换为90m 。 可空
show_url="http://m.taobao.id12345/detail"商品展示地址,可空
extern_token="1b258b84ed2faf3e88b4d979ed9fd4db"//授权令牌,开放平台返回的包含账户信息的token (授权令牌,商户在一定时间内对支付宝某些服务的访问权限)。 可空
重点说下待签名字符串,签名字符串;
支付接口 待签名字符串,字符串都是以key="value"中间用&分隔形式组成,即下面这个样子:
service="mobile.securitypay.pay"&partner="2088101568338364"&_input_charset="utf-8"¬ify_url="http://notify.msp.hk/notify.htm"&seller_id="alipay-test01@alipay.com"&out_trade_no="0819145412-6177"&subject="《暗黑破坏神 3:凯恩之书》"&body=""阿迪达斯上衣"&payment_type="1"&total_fee="0.01"
签名字符串就是:待签名字符串&sign="签名字符串"&sign_type="RSA",sign的value是待签名字符串用私钥加密后的字符串,例子如下:
service="mobile.securitypay.pay"&partner="2088101568338364"&_input_charset="utf-8"¬ify_url="http://notify.msp.hk/notify.htm"&seller_id="alipay-test01@alipay.com"&out_trade_no="0819145412-6177"&subject="《暗黑破坏神 3:凯恩之书》"&body=""阿迪达斯上衣"&payment_type="1"&total_fee="0.01"&sign="hkFZr+zE9499nuqDNLZEF7W75RFFPsly876QuRSeN8WMaUgcdR00IKy5ZyBJ4eldhoJ/2zghqrD4E2G2mNjs3aE+HCLiBXrPDNdLKCZgSOIqmv46TfPTEqopYfhs+o5fZzXxt34fwdrzN4mX6S13cr3UwmEV4L3Ffir/02RBVtU="&sign_type="RSA"
支付订单调用的Alipay.pay(String param)中的param就是上面的签名字符串。请求正确的话,界面就会跳转到支付界面,如图支付.png
/*
* Copyright (C) 2010 The MobileSecurePay Project
* All right reserved.
* author: shiqun.shi@alipay.com
*
* 提示:如何获取安全校验码和合作身份者id
* 1.用您的签约支付宝账号登录支付宝网站(www.alipay.com)
* 2.点击“商家服务”(https://b.alipay.com/order/myorder.htm)
* 3.点击“查询合作者身份(pid)”、“查询安全校验码(key)”
*/
package com.alipay.android.msp.demo;
//
// 请参考 Android平台安全支付服务(msp)应用开发接口(4.2 RSA算法签名)部分,并使用压缩包中的openssl RSA密钥生成工具,生成一套RSA公私钥。
// 这里签名时,只需要使用生成的RSA私钥。
// Note: 为安全起见,使用RSA私钥进行签名的操作过程,应该尽量放到商家服务器端去进行。
public final class Keys {
// 合作身份者id,以2088开头的16位纯数字,==支付宝给申请移动支付的商家的一个ID,签约的支付宝账号对应的支付宝唯一用户号==
public static final String DEFAULT_PARTNER = "2088812345675113";
// 收款支付宝账号==卖家的支付宝账号,可以是邮箱,电话号码或上面的2088开头的那个ID==
public static final String DEFAULT_SELLER = "xiaoming@qq.com";
//交易订单号
public static final String TRADE_NO = "032014012345676884";
//异步通知的地址
public static final String notify_url = "http://152.110.113:4275/manager/pay/alipay/notify";
// 商户私钥,自助生成,客户端自己通过下载下来的文件WS_SECURE_PAY_SDK\openssl\bin\spenssl。exe生成私钥和公钥
/**
* RSA密钥使用逻辑:
* 商户在使用RSA签名方式的支付宝接口时,真正会用到的密钥是商户私钥与支付
* 宝公钥。商户上传公钥给支付宝,支付宝把公钥给商户,是公钥互换的操作。这就 使得商户使用自己的私钥做签名时,支付宝端会根据商户上传的公钥做验证签名。
* 商户使用支付宝公钥做验证签名时,同理,也是因为支付宝用支付宝私钥做了签名。
*/
public static final String PRIVATE = "签约支付宝商户有效的私钥字符串,可惜我没有0.0";
// 商户公钥,是用我们自己生成的公钥跟支付宝交换的公钥。
public static final String PUBLIC = "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCnxj/9qwVfgoUh/y2W89L6BkRAFljhNhgPdyPuBV64bfQNN1PjbCzkIM6qRdKBoLPXmKKMiFYnkd6rAoprih3/PrQEB/VsW8OoM8fxn67UDYuyBTqA23MML9q1+ilIZwBC2AQ2UBVOrFXfFl75p6/B5KsiNG9zpgmLCUYuLkxpLQIDAQAB";
}
package com.alipay.android.msp.demo;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.Date;
import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlPullParserException;
import android.app.Activity;
import android.content.res.XmlResourceParser;
import android.os.Bundle;
import android.os.Handler;
import android.os.Message;
import android.text.TextUtils;
import android.util.Log;
import android.view.LayoutInflater;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.view.View.OnClickListener;
import android.view.ViewGroup;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.BaseAdapter;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ListView;
import android.widget.TextView;
import android.widget.Toast;
import com.alipay.android.app.sdk.AliPay;
public class ExternalPartner extends Activity implements OnItemClickListener,
OnClickListener {
public static final String TAG = "alipay-sdk";
private static final int RQF_PAY = 1;
private static final int RQF_LOGIN = 2;
private EditText mUserId;
private Button mLogon;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.external_partner);
initProducts();
initListView();
}
/*
* (non-Javadoc)
*
* @see android.app.Activity#onCreateOptionsMenu(android.view.Menu)
*/
@Override
public boolean onCreateOptionsMenu(Menu menu) {
menu.add(Menu.NONE, Menu.FIRST, 1, "快速登录");
return true;
}
/*
* (non-Javadoc)
*
* @see android.app.Activity#onOptionsItemSelected(android.view.MenuItem)
*/
@Override
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
case Menu.FIRST:
setContentView(R.layout.trustlogin);
mUserId = (EditText) findViewById(R.id.user_id);
mLogon = (Button) findViewById(R.id.get_token);
mLogon.setOnClickListener(this);
break;
}
return false;
}
/**
* 初始化产品列表
*/
private void initProducts() {
if (sProducts != null)
return;
XmlResourceParser parser = getResources().getXml(R.xml.products);
ArrayList<Product> products = new ArrayList<Product>();
Product product = null;
try {
int eventType = parser.getEventType();
while (eventType != XmlPullParser.END_DOCUMENT) {
if (eventType == XmlPullParser.START_TAG
&& parser.getName().equalsIgnoreCase("product")) {
product = new Product();
product.subject = parser.getAttributeValue(0);
product.body = parser.getAttributeValue(1);
product.price = parser.getAttributeValue(2);
products.add(product);
}
eventType = parser.next();
}
sProducts = new Product[products.size()];
products.toArray(sProducts);
} catch (XmlPullParserException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
@Override
public void onItemClick(AdapterView<?> arg0, View arg1, int position,
long arg3) {
try {
Log.i("ExternalPartner", "onItemClick");
String info = getNewOrderInfo(position);
// String sign = Rsa.sign(info, Keys.PRIVATE);//获取sign字符串
String sign = "";
sign = URLEncoder.encode(sign);// 由于我无法申请到支付宝的快捷支付服务,所以无法获取有效的私钥公钥,只能根据项目中获取的参数适当的进行调整,到最后,调整来调整去发现,调整的参数必须与原数据保持高度的一致。可能是支付宝那端也是将订单信息中的sign字段进行解密,然后比对参数是否一致
sign = "DSt%2BKjh7gTCk%2BB04tr7eRNE6H4FXI617zTBTan8jO8kTB9oNaHeBMwN8jTRXhYsUhUH%2FtHu57L7mELm8agWwEMKkeFwS9GmTWDHWTkv2d9vgdEKTQoUwFF76UJxkJVQmRY9Fi%2FEIfv2CRwJR9kuNhnKb6eZYrfdCdAfvdzncQXI%3D";
info += "&sign=\"" + sign + "\"&sign_type=\"RSA\"";
Log.i("ExternalPartner", "start pay");
// start the pay.
Log.i(TAG, "info = " + info);
//从公司获取的支付参数
// info =
// "partner=\"2088812345675113\"&out_trade_no=\"032011234511576884\"&subject=\"阿迪达斯三叶草_2014-07-17\"&body=\"上衣\"&total_fee=\"0.01\"¬ify_url=\"http%3A%2F%2F110.123.152%3A4085%2Fmanager%2Fpay%2Falipay%2Fnotify\"&service=\"mobile.securitypay.pay\"&_input_charset=\"utf-8\"&payment_type=\"1\"&seller_id=\"xiaoming@qq.com\"&it_b_pay=\"13m\"&sign=\"DSt%2BKjh7gTCk%2BB04tr7eRNE6H4FXI617zTBTan8jO8kTB9oNaHeBMwN8jTRXhYsUhUH%2FtHu57L7mELm8agWwEMKkeFwS9GmTWDHWTkv2d9vgdEKTQoUwFF76UJxkJVQmRY9Fi%2FEIfv2CRwJR9kuNhnKb6eZYrfdCdAfvdzncQXI%3D\"&sign_type=\"RSA\"";
final String orderInfo = info;
new Thread() {
public void run() {
AliPay alipay = new AliPay(ExternalPartner.this, mHandler);
// 设置为沙箱模式,不设置默认为线上环境
// alipay.setSandBox(true);
String result = alipay.pay(orderInfo);
Log.i(TAG, "result = " + result);
Message msg = new Message();
msg.what = RQF_PAY;
msg.obj = result;
mHandler.sendMessage(msg);
}
}.start();
} catch (Exception ex) {
ex.printStackTrace();
Toast.makeText(ExternalPartner.this, R.string.remote_call_failed,
Toast.LENGTH_SHORT).show();
}
}
/**
* 支付接口待签名字符串,字符串都是以key="value"中间用&分隔形式组成 ==订单信息未加密前的字符串==
*/
private String getNewOrderInfo(int position) {
StringBuilder sb = new StringBuilder();
sb.append("partner=\"");// 支付宝合作商户ID
sb.append(Keys.DEFAULT_PARTNER);
sb.append("\"&out_trade_no=\"");// 订单号
sb.append(getOutTradeNo());
sb.append("\"&subject=\"");// 订单主题
sb.append(sProducts[position].subject);
sb.append("\"&body=\"");// 订单内容
sb.append(sProducts[position].body);
sb.append("\"&total_fee=\"");// 订单价格
sb.append(sProducts[position].price.replace("一口价:", ""));
sb.append("\"¬ify_url=\"");// 异步通知到哪儿(url指定)
sb.append(URLEncoder.encode(Keys.notify_url));// URl需要进行编码
sb.append("\"&service=\"mobile.securitypay.pay");// 调用的SDK服务接口,是个固定值
sb.append("\"&_input_charset=\"utf-8");// 指定字符集,固定值UTF-8,支付宝只支持这,不知道GBK
// sb.append("\"&return_url=\"");//不知道干嘛的
// sb.append(URLEncoder.encode("http://m.alipay.com"));
sb.append("\"&payment_type=\"1");// 字符类型,1表示购买商品;或许还有其它的类型,我暂时不知道
sb.append("\"&seller_id=\"");// 卖家支付宝账号,需与申请快捷支付的支付宝账号一致
sb.append(Keys.DEFAULT_SELLER);
// 如果show_url值为空,可不传
// sb.append("\"&show_url=\"");//商品展示地址
sb.append("\"&it_b_pay=\"13m");// 支付超时时间,超过设置时间自动取消
sb.append("\"");
return new String(sb);
}
/**
* tradeNo 由商户端产生的唯一订单号,并不是支付宝的交易单号
* @return
*/
private String getOutTradeNo() {
// SimpleDateFormat format = new SimpleDateFormat("MMddHHmmss");
// Date date = new Date();
// String key = format.format(date);
//
// java.util.Random r = new java.util.Random();
// key += r.nextInt();
// key = key.substring(0, 15);
// Log.d(TAG, "outTradeNo: " + key);
// return key;
return "032014071711576884";
}
private void initListView() {
ListView lv = (ListView) findViewById(R.id.list_view);
lv.setAdapter(new ExternalPartnerAdapter());
lv.setOnItemClickListener(this);
}
private void doLogin() {
final String orderInfo = getUserInfo();
new Thread() {
public void run() {
String result = new AliPay(ExternalPartner.this, mHandler)
.pay(orderInfo);
Log.i(TAG, "result = " + result);
Message msg = new Message();
msg.what = RQF_LOGIN;
msg.obj = result;
mHandler.sendMessage(msg);
}
}.start();
}
private String getUserInfo() {
String userId = mUserId.getText().toString();
return trustLogin(Keys.DEFAULT_PARTNER, userId);
}
private String trustLogin(String partnerId, String appUserId) {
StringBuilder sb = new StringBuilder();
sb.append("app_name=\"mc\"&biz_type=\"trust_login\"&partner=\"");
sb.append(partnerId);
Log.d("TAG", "UserID = " + appUserId);
if (!TextUtils.isEmpty(appUserId)) {
appUserId = appUserId.replace("\"", "");
sb.append("\"&app_id=\"");
sb.append(appUserId);
}
sb.append("\"");
String info = sb.toString();
// 请求信息签名
String sign = Rsa.sign(info, Keys.PRIVATE);
try {
sign = URLEncoder.encode(sign, "UTF-8");
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
info += "&sign=\"" + sign + "\"&sign_type=\"RSA\"";
return info;
}
@Override
public void onClick(View v) {
if (v instanceof Button) {
switch (v.getId()) {
case R.id.get_token:
doLogin();
break;
}
}
}
private class ExternalPartnerAdapter extends BaseAdapter {
@Override
public int getCount() {
return sProducts.length;
}
@Override
public Object getItem(int arg0) {
return sProducts[arg0];
}
@Override
public long getItemId(int position) {
return position;
}
@Override
public View getView(int position, View convertView, ViewGroup parent) {
if (convertView == null) {
LayoutInflater factory = LayoutInflater
.from(ExternalPartner.this);
convertView = factory.inflate(R.layout.product_item, null);
}
Product product = (Product) getItem(position);
TextView tv = (TextView) convertView.findViewById(R.id.subject);
tv.setText(product.subject);
tv = (TextView) convertView.findViewById(R.id.body);
tv.setText(product.body);
tv = (TextView) convertView.findViewById(R.id.price);
tv.setText(product.price);
return convertView;
}
}
Handler mHandler = new Handler() {
public void handleMessage(android.os.Message msg) {
Result result = new Result((String) msg.obj);
switch (msg.what) {
case RQF_PAY:
case RQF_LOGIN: {
Toast.makeText(ExternalPartner.this, result.getResult(),
Toast.LENGTH_SHORT).show();
}
break;
default:
break;
}
};
};
public static class Product {
public String subject;
public String body;
public String price;
}
public static Product[] sProducts;
}