支付宝接口开发:客户端服务器端

本文是看到网上一位大神分享的博客,担心以后找不到,所以就记录一下,并非本人原创,参考博文地址:http://my.oschina.net/daniels/blog/597356

这两天软件需要集成支付宝了,第一次集成,过程还是挺简单的,不过由于支付宝官方文档写的不够清晰,也是走了一些弯路,下面把过程写出来分享给大家

一、申请移动支付权限

首先登录【支付宝开放平台】http://open.alipay.com/platform/home.htm,添加应用,申请移动支付权限。申请开通支付,是需要公司文件的,个人是不允许开始支付的。
具体细节就不再详聊了,下面就讲讲如何将阿里给出的demo运行起来。

二、阿里支付DEMO

1、概述

(1)支付调用页面及测试

支付宝在调用时,会首先看本地是不是存在支付宝客户端,如果有的话,就直接调用客户端进行支付,如果没有,则调用jar包中的H5页面支付。
所以在测试时,需要有测试两种情境:有支付宝客户端和没有支付宝客户端的情况。

(2)、客户端与服务器

在demo中大家可以看到,有客户端的demo也有服务端的demo,大家可能觉得需要服务端写好之后,客户端才能集成,其实并不是。整个流程是这样的:
1,APP客户端通过SDK发送支付请求 (客户端处理)
2,SDK支付成功并同步返回支付结果(客户端处理)
3,支付宝服务器向我们的服务器发送支付结果字符串(服务端处理)
客户端:从上面的流程可以看出,服务端只是用来接出异步返回的支付结果的。而支付与同步结果返回都是在客户端可以直接看得到的。所以在集成支付宝支付接口时,主要功能是在客户端,即便服务端没有做集成,也是可能付款成功的。
服务端:服务端只需要添加一个功能:接口支付结果返回

下面几张图显示了整个demo的运行过程,由于没办法在真机上录制gif,所以只能用图片来代替了。
初始化界面:

点击支付后,跳出确认付款界面:

点击确认付款后,跳出输入密码界面:

最后是支付成功界面:

在看DEMO的代码之前,我们需要先配置几个变量:

2、配置几个变量

这部分会对代码中用到的几个变量的找到方法或生成方法进行讲述,部分资料引自支付宝开放平台。

(1)PID

合作者身份ID(PID)是商户与支付宝签约后,商户获得的支付宝商户唯一识别码。当商户把支付宝功能接入商户网站时会用到PID,以便让支付宝认证商户。
查看PID步骤如下:
1、登录支付宝官方网站b.alipay.com
2、点击导航栏中“商家服务”

3、点击“查询PID、Key”

(2)、APPID、APP SECRET和支付宝公钥

在https://openhome.alipay.com/platform/createApp.htm页面,创建一个应用

完成之后:在我的应用中是可以看得到的:

然后转到帐户基本信息页面:https://openhome.alipay.com/platform/keyManage.htm

在开放平台密钥栏,可以找到APPID,APP SECRET,和支付宝密钥
这三个数据,都是在应用创建后,支付宝为我们生成好的,无法更改!

(3)、生成商户私钥【windows生成方法】

(有关mac的生成方法,下面会再补充)
1、下载DEMO及SDK
到文档中心,查看移动支付对应的文档,文档地址:http://doc.open.alipay.com/doc2/detail?treeId=59&articleId=103563&docType=1
然后,点击(SDK&DEMO下载)下载代码

2、得到原始私钥
在代码中的DEMO/openssl/bin目录下,有openssl.exe文件

打开openssl.exe
输入

genrsa -out rsa_private_key.pem 1024

得到生成成功的结果,如下图:

此时,我们可以在bin文件夹中看到一个文件名为rsa_private_key.pem的文件

用记事本方式打开它,可以看到-----BEGIN RSA PRIVATE KEY-----开头,-----END RSA PRIVATEKEY-----结尾的没有换行的字符串,这个就是原始的私钥。

但这段原始私钥代码中是用不到的,我们需要将它转化为PKCS8格式
3、转换为PKCS8格式
在openssl.exe中输入:并回车

pkcs8 -topk8 -inform PEM -in rsa_private_key.pem -outform PEM -nocrypt

得到生成功的结果,这个结果就是PKCS8格式的私钥,如下图:

注意,私钥是红框包括的那部分,是不包含BEGIN PRIVATE KEY和END PRIVATE KEY这两行的。

右键点击openssl窗口上边边缘,选择编辑→标记,选中要复制的文字(如上图),
此时继续右键点击openssl窗口上边边缘,选择编辑→复制,
把复制的内容粘土进一个新的记事本中,可随便命名,只要知道这个是PKCS8格式的私钥即可。

(4)、生成商户私钥【MAC生成方法】

这里来讲一下mac端如何生成用户私钥的,由于mac系统是自带openssl的,所以只需要打开终端,利用cd 命令切到任意一个想存放生成Key的文件夹下:
比如,切到下载目录下

然后运行下面的命令来生成私钥原始密钥

openssl genrsa -out rsa_private_key.pem 1024

然后运行下面的命令来生成转换的PCKS8格式的命令。

openssl pkcs8 -topk8 -inform PEM -in rsa_private_key.pem -outform PEM -nocrypt

然后将生成的私钥复制保存起来。
从上面的命令可以看出,与windows相比,mac上需要在前面添加openssl指定运行的是openssl命令。其它命令是完全一致的。

(5)、生成用户公钥及网页填充

1、生成公钥
同样对于windows用户而言,直接在openssl.exe中输入下面的命令:

rsa -in rsa_private_key.pem -pubout -out rsa_public_key.pem

同样,如果是Mac的同学,输入的命令应该是如下:

openssl rsa -in rsa_private_key.pem -pubout -out rsa_public_key.pem

得到生成成功的结果,如下图:

此时,我们可以在bin文件夹中看到一个文件名为rsa_public_key.pem的文件,用记事本方式打开它,可以看到-----BEGIN PUBLICKEY-----开头,
-----END PUBLIC KEY-----结尾的没有换行的字符串,这个就是公钥。

在生成网页以后,复制----BEGIN PUBLICKEY-----和-----ENDPUBLIC KEY-----之间的部分,即那段纯代码,不要把----BEGINPUBLIC KEY-----和-----ENDPUBLIC KEY-----给复制进去了。中间的这部分就是公钥。
2、网页填充
然后到https://openhome.alipay.com/platform/keyManage.htm?keyType=partner(需要 登录)中,左侧找到合作伙伴密钥栏,再到右侧的RSA加密中,将公钥粘贴进去。由于,我们已经粘贴进去了,所以这里显示查看开发者公钥,在没填之前写的是 “添加开发者公钥”

到这里,所有的准备工作都已经结束了。下面就是配置DEMO的过程了

3、配置DEMO

在刚才下载的sdk&demo的源码中,打开DEMO/客户端demo/支付宝Android15.0.1/alipay_demo工程
路径如下:

在PayDemoActivity中配置几个变量:

//PID
public static final String PARTNER = "";

在这里填上我们上面找到的PID;

// 商户收款账号
public static final String SELLER = "[email protected]";

然后在SELLER上写上我们支付宝的登录帐户,即那个你申请移动支付的支付宝账号

// 支付宝公钥
public static final String RSA_PUBLIC ="";

然后在RSA_PUBLIC这里填上支付宝公钥

// 商户私钥,pkcs8格式
public static final String RSA_PRIVATE = "";

最后是填上RSA_PRIVATE对应的商户私钥,注意是PKCS8格式的。
私钥这部分,注意是----BEGIN PUBLICKEY-----和-----ENDPUBLIC KEY-----之间的部分,即那段纯代码,不要把----BEGINPUBLIC KEY-----和-----ENDPUBLIC KEY-----给复制进去了。中间的这部分就是公钥。

现在运行demo就直接可以支付了。

本文中对应的DEMO在文章底部给出。

4、代码讲解

通过上面的配置,demo应该就直接可以运行了,但这里所涉及的代码,我们再仔细看看
主要的支付与结果返回就是pay()这个函数,这里完成了支付所需要的所有功能。代码如下:

 
  1. public void pay(View v) {

  2.  
  3. …………

  4.  
  5. // 订单信息

  6.  
  7. String orderInfo = getOrderInfo("测试的商品", "该测试商品的详细描述", "0.01");

  8.  
  9.  
  10.  
  11. // 对订单做RSA 签名

  12.  
  13. String sign = sign(orderInfo);

  14.  
  15. try {

  16.  
  17. // 仅需对sign 做URL编码

  18.  
  19. sign = URLEncoder.encode(sign, "UTF-8");

  20.  
  21. } catch (UnsupportedEncodingException e) {

  22.  
  23. e.printStackTrace();

  24.  
  25. }

  26.  
  27.  
  28.  
  29. // 完整的符合支付宝参数规范的订单信息

  30.  
  31. final String payInfo = orderInfo + "&sign=\"" + sign + "\"&"

  32.  
  33. + getSignType();

  34.  
  35.  
  36.  
  37. Runnable payRunnable = new Runnable() {

  38.  
  39.  
  40.  
  41. @Override

  42.  
  43. public void run() {

  44.  
  45. // 构造PayTask 对象

  46.  
  47. PayTask alipay = new PayTask(PayDemoActivity.this);

  48.  
  49. // 调用支付接口,获取支付结果

  50.  
  51. String result = alipay.pay(payInfo);

  52.  
  53.  
  54.  
  55. Message msg = new Message();

  56.  
  57. msg.what = SDK_PAY_FLAG;

  58.  
  59. msg.obj = result;

  60.  
  61. mHandler.sendMessage(msg);

  62.  
  63. }

  64.  
  65. };

  66.  
  67.  
  68.  
  69. // 必须异步调用

  70.  
  71. Thread payThread = new Thread(payRunnable);

  72.  
  73. payThread.start();

  74.  
  75. }

  76.  
  77.  

这里总是分了四步来完成支付与结果接收。

第一步:构造定单信息:

String orderInfo = getOrderInfo("测试的商品", "该测试商品的详细描述", "0.01");

主要是这句,即在getOrderInfo()函数中完成定单信息的构造:(这里对getOrderInfo函数做的精减,更多字段及意义参考源码)

有关paymethod的方法使用,参考:https://cshall.alipay.com/support/help_detail.htm?help_id=476935
各个字段的意义及取值参考:http://doc.open.alipay.com/doc2/detail?treeId=59&articleId=103663&docType=1

 
  1. public String getOrderInfo(String subject, String body, String price) {

  2.  
  3.  
  4.  
  5. // 签约合作者身份ID

  6.  
  7. String orderInfo = "partner=" + "\"" + PARTNER + "\"";

  8.  
  9.  
  10.  
  11. // 签约卖家支付宝账号

  12.  
  13. orderInfo += "&seller_id=" + "\"" + SELLER + "\"";

  14.  
  15.  
  16.  
  17. // 商户网站唯一订单号

  18.  
  19. orderInfo += "&out_trade_no=" + "\"" + getOutTradeNo() + "\"";

  20.  
  21.  
  22.  
  23. // 商品名称

  24.  
  25. orderInfo += "&subject=" + "\"" + subject + "\"";

  26.  
  27.  
  28.  
  29. // 商品详情

  30.  
  31. orderInfo += "&body=" + "\"" + body + "\"";

  32.  
  33.  
  34.  
  35. // 商品金额

  36.  
  37. orderInfo += "&total_fee=" + "\"" + price + "\"";

  38.  
  39.  
  40.  
  41. // 服务器异步通知页面路径

  42.  
  43. orderInfo += "¬ify_url=" + "\"" + "http://notify.msp.hk/notify.htm"

  44.  
  45. + "\"";

  46.  
  47.  
  48.  
  49. …………

  50.  
  51. return orderInfo;

  52.  
  53. }

这里就是通过我们的提供的商家ID,产品信息,价格等信息来构造定单及回调页面,这里需要非常注意的一个地方:

 
  1. // 服务器异步通知页面路径

  2.  
  3. orderInfo += "&noify_url=" + "\"" + "http://notify.msp.hk/notify.htm"

  4.  
  5. + "\"";

服务器异 步通知页面路径,首先我们用支付宝支付之后,支付宝会返回给我们两个通知,一个是同步的,就是我们点击支付后支付宝直接反馈给我们客户端的信息,我们可以 直接拿到,根据反馈的结果可以初步判定该次交易是否成功,第二个就是服务器异步的通知,这个异步的通知是支付宝的服务器端发给我们服务器端的信息,我们在 客户端是直接获取不了的,那支付宝的服务器怎么知道我们服务器的路径呢,那就是这参数的作用了,我们给支付宝服务器一个路径,它就会在订单状态改变的时候 给我们服务器端一个反馈,告诉服务器这次交易的状态,如果服务器结果判定该次交易成功了,就必须返给支付宝服务器一个success,要不服务器会一直给 我们异步通知,因为它不知道该次交易是否完成了(一般情况下25小时内8次通知,频率一般是2m 10m 10m 1h 2h 6h15h),我们一般会在收到异步通知时,对订单的状态进行更新。
其它的就不讲了,通过看源码都能看得懂,比如构造订单号啥的。

第二步:对订单字符串做RSA签名

为什么要签名呢?当然是防止传输出错了,这可是跟钱相关的,如果orderInfo传输过程中出错了,那怎么样来校验它是不是出错了呢,只有通过签名算法来了。所以这里就需要对订单字符串做签名。
具体签名算法就不讲了,直接应用到项目中就行,不需要理解,如果想看看怎么实现的,里面有对应的源码,可以去研究一下。

 
  1. // 对订单做RSA 签名

  2.  
  3. String sign = sign(orderInfo);

  4.  
  5. try {

  6.  
  7. // 仅需对sign 做URL编码

  8.  
  9. sign = URLEncoder.encode(sign, "UTF-8");

  10.  
  11. } catch (UnsupportedEncodingException e) {

  12.  
  13. e.printStackTrace();

  14.  
  15. }

第三步:构造完成的请求字符串

在订单字符串和签名做完以后,就可以用他们来构造完整的请求字符串了:

 
  1. // 完整的符合支付宝参数规范的订单信息

  2.  
  3. final String payInfo = orderInfo + "&sign=\"" + sign + "\"&"

  4.  
  5. + getSignType();

第四步:请求与结果返回

最后是发送请求,代码如下:

 
  1. Runnable payRunnable = new Runnable() {

  2.  
  3.  
  4.  
  5. @Override

  6.  
  7. public void run() {

  8.  
  9. // 构造PayTask 对象

  10.  
  11. PayTask alipay = new PayTask(PayDemoActivity.this);

  12.  
  13. // 调用支付接口,获取支付结果

  14.  
  15. String result = alipay.pay(payInfo);

  16.  
  17.  
  18.  
  19. Message msg = new Message();

  20.  
  21. msg.what = SDK_PAY_FLAG;

  22.  
  23. msg.obj = result;

  24.  
  25. mHandler.sendMessage(msg);

  26.  
  27. }

  28.  
  29. };

  30.  
  31.  
  32.  
  33. // 必须异步调用

  34.  
  35. Thread payThread = new Thread(payRunnable);

  36.  
  37. payThread.start();

  38.  
  39. 最关键的部分在这里:

  40.  
  41. PayTask alipay = new PayTask(PayDemoActivity.this);

  42.  
  43. // 调用支付接口,获取支付结果

  44.  
  45. String result = alipay.pay(payInfo);

  46.  
  47.  
  48.  
  49. Message msg = new Message();

  50.  
  51. msg.what = SDK_PAY_FLAG;

  52.  
  53. msg.obj = result;

  54.  
  55. mHandler.sendMessage(msg);

在String result = alipay.pay(payInfo);中,就直接获得了支付结果;
然后通过handler将结果发送出去。
这就是同步的方式获取支付结果的方式。
好了,有关支付宝对接的方法全部都在这了。至于getOrderInfo函数里,使用的调用银行卡支付,我觉得也没啥用,在我们程序里也没接上。

本文所使用的DEMO源码下载地址:http://download.csdn.net/detail/harvic880925/9261363

如果本文有帮到你,记得加关注哦。

文章来自: http://my.oschina.net/daniels/blog/597356

猜你喜欢

转载自blog.csdn.net/andrewniu/article/details/81235496
今日推荐