手把手教你接入支付宝支付

谁借莪１个温暖的怀抱￠ 2022-03-22 19:26 492阅读 0赞

前一久做了支付宝支付，分享一下接入的详细步骤吧，移动端和服务端demo源码已上传至GitHub，要下载的移步至文章末尾。  
先给出支付宝官方文档：[https://docs.open.alipay.com/204/105051/][https_docs.open.alipay.com_204_105051]

##### 适用场景 #####

在App内集成支付宝支付。APP调用支付宝提供的SDK，SDK再调用支付宝APP内的支付模块。如果用户已安装支付宝APP，商家APP会跳转到支付宝中完成支付，支付完后跳回到商家APP内。如果用户没有安装支付宝APP，商家APP内会调起支付宝网页支付收银台，用户登录支付宝账户，支付完后展示支付结果。

##### 接入 #####

###### 1. 创建应用并获取APPID ######

地址：[https://open.alipay.com/platform/appManage.htm\#/apps][https_open.alipay.com_platform_appManage.htm_apps]  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70][]

创建应用后即生成应用的标识APPID  
创建指南：[https://docs.open.alipay.com/200/105310/][https_docs.open.alipay.com_200_105310]

###### 2. 添加App支付功能 ######

从我的应用列表点击应用对应的查看详情按钮进入  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70 1][]

添加完成后，若应用状态为开发中状态，只能在沙箱环境下进行调试。应用申请上线后，会同时申请此列表的功能，接口即生效。

注：手机端支付可以添加 APP支付 和手机网站支付。APP支付使用原生开发，调用支付宝支付SDK。手机网站支付是在网页中调用支付宝，所以使用h5+mui方式开发APP可使用此功能，无需跳转至原生。这里根据需要酌情选择。

###### 3. 签约 ######

在功能列表中点击签约，签约后才能正常使用，签约前可使用沙箱模式进行调试。

以上的步骤可以交给公司相关人员进行申请，开发人员请看下面

--------------------

##### 密钥配置 #####

###### 1. 支付宝密钥处理体系 ######

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70 2][]

所以需要获取到应用公钥、应用私钥以及支付宝公钥：

①**应用公钥**  
由商户自己生成的RSA公钥（与应用私钥必须匹配），商户需上传应用公钥到支付宝开放平台，以便支付宝使用该公钥验证该交易是否是商户发起的。

②**应用私钥**  
由商户自己生成的RSA私钥（与应用公钥必须匹配），商户开发者使用应用私钥对请求字符串进行加签。

③**支付宝公钥**  
支付宝的RSA公钥，商户使用该公钥验证该结果是否是支付宝返回的。

###### 2. 获取密钥和密钥配置 ######

步骤：[https://docs.open.alipay.com/200/105310\#s2][https_docs.open.alipay.com_200_105310_s2]  
签名专区：[https://docs.open.alipay.com/291/106103/][https_docs.open.alipay.com_291_106103]  
密钥生成工具：[https://docs.open.alipay.com/291/106097/][https_docs.open.alipay.com_291_106097]

注：使用密钥生成工具生成密钥时，要注意密钥格式，如果服务端使用.Net或其他非java语言，一定要选PKCS1(非JAVA适用)，否则后面要凉凉。密钥长度建议选择2048。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70 3][]

##### 集成开发 #####

使用App支付功能需要在原生中实现，这里以Android为例。接入移动支付需要集成两个SDK，分别是客户端的SDK和服务端的SDK。

SDK下载地址：  
客户端[https://docs.open.alipay.com/54/104509][https_docs.open.alipay.com_54_104509]  
服务端[https://docs.open.alipay.com/54/106370/][https_docs.open.alipay.com_54_106370]

注：为何需要两个SDK？因为客户端不能含有敏感信息，包括密钥、APPID等，这些东西都必须从服务端获取，包括加签验签过程，所以还需要集成一个服务端给APP调用。

###### 客户端（Android）SDK集成 ######

集成方法：[https://docs.open.alipay.com/204/105296/][https_docs.open.alipay.com_204_105296]

###### （1）发起支付请求 ######

支付宝SDK中提供了一个PayTask类，使用其payV2方法即可发起支付请求。

/** * 支付（加签过程不允许在客户端进行，必须在服务端，否则有极大的安全隐患） * * @param orderInfo 加签后的支付请求参数字符串（主要包含商户的订单信息，key=value形式，以&连接）。 */
    private void pay(final String orderInfo) { 
        final Runnable payRunnable = new Runnable() { 
            @Override
            public void run() { 
                PayTask alipay = new PayTask(MainActivity.this);
                //第二个参数设置为true，将会在调用pay接口的时候直接唤起一个loading
                Map<String, String> result = alipay.payV2(orderInfo, true);
                
                Message msg = new Message();
                msg.what = SDK_PAY_FLAG;
                msg.obj = result;
                mHandler.sendMessage(msg);
            }
        };
    
        // 必须异步调用
        Thread payThread = new Thread(payRunnable);
        payThread.start();
    }

参数：  
orderInfo: app支付请求参数字符串，主要包含商户的订单信息，key=value形式，以&连接。由众多请求参数加签以及非对称加密后生成。  
具体参数说明请看文档：[https://docs.open.alipay.com/204/105465/][https_docs.open.alipay.com_204_105465]

所以发起支付请求的重点在于获取orderInfo，也就是从服务端获取**加签**结果，加签过程不允许在客户端进行，否则可能被反编译，造成严重的后果。所以加签过程请看下面服务端（.Net）SDK集成的第（1）条。

###### （2）支付回调 ######

调用支付宝支付后，将会收到同步通知和异步通知。如果过程中取消支付则只会收到同步通知。

**同步通知**：支付宝sdk对商户的请求支付数据处理完成后，会将结果同步反馈给app端。在支付回调中即可获取支付结果信息。  
**异步通知：** 对于App支付产生的交易，支付宝会根据原始支付API中传入的异步通知地址notify\_url，通过POST请求的形式将支付结果作为参数通知到商户系统。

**注：** 手机端同步通知有可能存在获取不到的情况，如手机关机，应用crash等情况，所以手机端同步回调只作为支付结果提示。真正的支付成功逻辑将在支付宝异步通知（服务端）中做处理，请看下面服务端（.Net）SDK集成的第（2）条。

so，手机端只做同步通知处理，如下：

Map<String, String> result = alipay.payV2(orderInfo, true);

result就是返回的同步回调结果，里面的resultStatus是支付状态码，如果是9000则支付成功。

if (TextUtils.equals(resultStatus, "9000")) { 
         // 该笔订单是否真实支付成功，需要依赖服务端的异步通知。
         showAlert(MainActivity.this, "支付成功" + payResult);
     } else { 
          // 该笔订单真实的支付结果，需要依赖服务端的异步通知。
          showAlert(MainActivity.this, "支付失败" + payResult);
     }

如果使用混合开发（h5+mui+原生），还需跳转至mui页面，则可使用js回调函数将同步通知传入mui端进行后续处理，如：

// 调用方法将原生代码的执行结果返回给js层并触发相应的JS层回调函数
    JSUtil.execCallback(mWebview, CallBackID, resultStatus, JSUtil.OK, false);

###### 服务端（.Net）SDK集成 ######

集成方法：[https://docs.open.alipay.com/54/106370/][https_docs.open.alipay.com_54_106370]

为了便于支付宝异步接口调用，这里服务端将使用webApi，服务端主要工作为加签、验签（异步通知验证）以及更改订单支付状态。

**(1)** **加签**

核心步骤：

//从pem文件中读取
    APP_PRIVATE_KEY = GetCurrentPathByAbs() + "rsa_private_key.pem";
    ALIPAY_PUBLIC_KEY = GetCurrentPathByAbs() + "rsa_alipay_public_key.pem";
    
    //最后一个参数为false直接将私钥内容写入代码，true从pem文件中读取
    IAopClient client = new DefaultAopClient(gateway, APPID, APP_PRIVATE_KEY, format, version, sign_type, ALIPAY_PUBLIC_KEY, CHARSET, true);
    //实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称如：alipay.trade.app.pay
    AlipayTradeAppPayRequest request = new AlipayTradeAppPayRequest();
    //SDK已经封装掉了公共参数，这里只需要传入业务参数。以下方法为sdk的model入参方式(model和biz_content同时存在的情况下取biz_content)。
     AlipayTradeAppPayModel model = new AlipayTradeAppPayModel();
    model.Body = body;
    model.Subject = subject;
    model.TotalAmount = total_amount;
    model.ProductCode = product_code;
    model.OutTradeNo = out_trade_no;
    model.TimeoutExpress = timeout_express;
    request.SetBizModel(model);
    request.SetNotifyUrl(notify_url);
    //这里和普通的接口调用不同，使用的是sdkExecute
    AlipayTradeAppPayResponse response = client.SdkExecute(request);
    
    string resp = response.Body;
    return resp;

支付宝服务端SDK中提供了一个SdkExcute方法，需要传入对应的request类AlipayTradeAppPayRequest。实例化IAopClient对象时需要传入请求网关(gateway)、APPID、应用私钥、支付宝公钥、调用的接口版本、编码方式、签名算法类型以及是否从文件中读取密钥的一个bool类型值。  
其中，签名算法类型应和配置密钥时选择的类型一致，另外2018年1月5号之后创建的应用都需要使用**RSA2**，也就是sign\_type=RSA2，否则会加签失败。最后一个bool型参数，为false直接从代码中读取密钥，为true则从pem文件中读取。

如果觉得密钥放在代码中不够安全的话，建议将密钥存储为pem文件，执行加签过程时从文件中读出，做法如下：

###### ① 生成pem文件 ######

pem文件是有格式的，就像这样

-----BEGIN RSA PRIVATE KEY-----
    MIIEogIBAjayyr4gU38hr/EYnXdbEfbaGkdVnvf6Y+9zWkkiPcNq-----这里是密钥内容
    -----END RSA PRIVATE KEY-----

生成pem文件需要使用openssl.exe这个可执行文件，当然也可以copy个pem文件替换下里面的密钥内容，不过这样有可能会导致格式乱了。openssl.exe在密钥生成工具的openssl的bin目录下，双击即可打开。  
![openssl.png][]

生成应用私钥pem文件，输入命令：genrsa -out rsa\_private\_key.pem 2048

![private\_key\_command.png][private_key_command.png]  
![private\_key\_pem.png][private_key_pem.png]

生成应用公钥pem文件，输入命令：rsa -in rsa\_private\_key.pem -pubout -out rsa\_public\_key.pem

![public\_key\_command.png][public_key_command.png]  
![public\_key\_pem.png][public_key_pem.png]

支付宝公钥需要上传应用公钥获取，如果不使用pem文件，代码中直接放上支付宝公钥就行，如果要使用pem文件，可以将应用公钥的pem文件复制一份，将密钥内容换成支付宝公钥的，格式如下。

-----BEGIN PUBLIC KEY-----
    MIGfMA0GCSqGSIb3DQEBAQUAADCBi----------这里是支付宝公钥
    -----END PUBLIC KEY-----

注：上面密钥的格式默认为PKCS1的，如果使用PKCS8(Java适用)别忘记执行转码命令，否则也要凉凉的。如果使用沙箱模式请将密钥换成沙箱版进行测试。

###### ② 从pem文件中读取密钥 ######

首先获取存放密钥文件的路径，为了防止出现意外，可获取文件的绝对路径，如下：

/// <summary>
    /// 获取私钥公钥的路径(绝对路径)
    /// </summary>
    /// <returns></returns>
    private static string GetCurrentPathByAbs()
    { 
        return HttpRuntime.AppDomainAppPath.ToString() + "rsa/";
    }

获取到文件路径后传入IAopClient的构造函数中，并将最后一个参数置为true即可。

IAopClient client = new DefaultAopClient(gateway, APPID, APP_PRIVATE_KEY, format, version, sign_type, ALIPAY_PUBLIC_KEY, CHARSET, true);

###### (2) 验签 ######

当支付宝发送异步通知时，会将支付结果的信息异步返回至服务端，服务端需要进行验签操作，验证请求是否是支付宝发送，并利用支付宝公钥进行比对，保证交易的安全性和正确性。主要步骤如下：  
①提供异步调用接口  
支付宝异步通知将以post的方式发起请求，所以我们需要编写一个webapi接口，并保证接口的正确性，如下：

/// <summary>
    /// 异步验签（客户端支付后，支付宝服务器将异步调用此方法）
    /// 实际支付逻辑在此操作，支付宝服务端将保证调用到此接口
    /// </summary>
    /// <returns></returns>
    [HttpPost]
    public string GetAsynchronousYanQian()
    { 
        return AlipayUtil.AsynchronousYanQian(GetRequestPost());
    }

这个接口地址便是加签过程中传入的异步通知地址notify\_url

②获取异步通知结果并验签  
官方文档地址：[https://docs.open.alipay.com/54/106370/][https_docs.open.alipay.com_54_106370]

上面这个链接支付宝介绍了如何获取通知参数并验签。但是部分代码是错的，请看我写的。  
获取支付宝异步通知结果如下：

/// <summary>
    /// 获取支付宝POST过来通知消息，并以“参数名=参数值”的形式组成数组 
    /// request回来的信息组成的数组
    /// </summary>
    /// <returns></returns>
    public Dictionary<string, string> GetRequestPost()
    { 
        int i = 0;
        IDictionary<string, string> sArray = new Dictionary<string, string>();
        NameValueCollection coll;
        coll = Request.Form;
    
        String[] requestItem = coll.AllKeys;
        for (i = 0; i < requestItem.Length; i++)
        { 
            sArray.Add(requestItem[i], Request.Form[requestItem[i]]);
        }
        return (Dictionary<string, string>)sArray;
    }

验签：  
验签过程支付宝AlipaySignature类提供了验签方法RSACheckV1和RSACheckV2，区别就不细说，这里使用RSACheckV1方法，第一个参数便是支付宝返回的异步通知结果，第二个参数传入支付宝公钥，同样最后一个参数传false从代码读取支付宝公钥，传true从pem 文件中读取。

bool flag = AlipaySignature.RSACheckV1(result, ALIPAY_PUBLIC_KEY, CHARSET, sign_type, true);

验签结果返回一个bool值，如果验签成功返回true，否则false。

③通知支付宝  
支付宝异步通知调用接口后，如果未收到成功反馈，将会在一段时间内重复发送异步通知，以保证服务端接收到异步通知。所以当验签成功并真正的改变订单支付状态后，需要给支付宝返回success。如果反馈给支付宝的字符不是success这7个字符，支付宝服务器会不断重发通知，直到超过24小时22分钟。一般情况下，25小时以内完成8次通知（通知的间隔频率一般是：4m,10m,10m,1h,2h,6h,15h）。

if (flag)
    { 
         //验签成功，将数据库中订单的支付状态改变
          if (ChangePayState())
          { 
            //如果数据库插入成功，通知支付宝已收到通知
            return "success";
           }
          else
          { 
              return "fail";
          }
    
    }
    else
    { 
        return "fail";
    }

注：如果在改变订单支付状态时需要的某些参数无法获取，可以将其拼接在加签过程中某些不是很必要的参数里，支付宝将在异步通知中返回。

###### 效果图 ######

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70 4][] ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70 5][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70 6][]

--------------------

以上便是支付宝支付的实现步骤，包括了移动端（原生）和服务端（.Net）。Demo已上传至GitHub，有兴趣的可以下载：

移动端：[https://github.com/yangxch/AlipayDemo][https_github.com_yangxch_AlipayDemo]  
服务端：[https://github.com/yangxch/AlipayServerAPIDemo][https_github.com_yangxch_AlipayServerAPIDemo]

原创不易，转载请注明：[https://blog.csdn.net/xch\_yang/article/details/86689642][https_blog.csdn.net_xch_yang_article_details_86689642]

[https_docs.open.alipay.com_204_105051]: https://docs.open.alipay.com/204/105051/
[https_open.alipay.com_platform_appManage.htm_apps]: https://open.alipay.com/platform/appManage.htm%23/apps
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70]: /images/20220322/2afefd7f92104e0f82ee12935ebd1d69.png
[https_docs.open.alipay.com_200_105310]: https://docs.open.alipay.com/200/105310/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70 1]: /images/20220322/8c0d9356faf1426fa37808dc479a575c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70 2]: /images/20220322/8a3709fced9d489398d1ae07b363a05f.png
[https_docs.open.alipay.com_200_105310_s2]: https://docs.open.alipay.com/200/105310#s2
[https_docs.open.alipay.com_291_106103]: https://docs.open.alipay.com/291/106103/
[https_docs.open.alipay.com_291_106097]: https://docs.open.alipay.com/291/106097/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70 3]: /images/20220322/e546e4d063bd48f69ed1325e3ea9f2ce.png
[https_docs.open.alipay.com_54_104509]: https://docs.open.alipay.com/54/104509
[https_docs.open.alipay.com_54_106370]: https://docs.open.alipay.com/54/106370/
[https_docs.open.alipay.com_204_105296]: https://docs.open.alipay.com/204/105296/
[https_docs.open.alipay.com_204_105465]: https://docs.open.alipay.com/204/105465/
[openssl.png]: /images/20220322/26670179e13c4bd3ae267db6032bedbe.png
[private_key_command.png]: /images/20220322/9e76c31a2953487a9f33d40c5d9b8f8c.png
[private_key_pem.png]: /images/20220322/7c1f558ed0b74878a3aa4e92647d023d.png
[public_key_command.png]: /images/20220322/20c5d014e80a49e388fb01f397abb3ba.png
[public_key_pem.png]: /images/20220322/bf2eeae7226345648eff9db928446ffc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20190129114440857.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70 5]: /images/20220322/6894b10d72684a96bafb1dddccfeaa67.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hjaF95YW5n_size_16_color_FFFFFF_t_70 6]: /images/20220322/ff8e45772a92431289ac61ad02d06e92.png
[https_github.com_yangxch_AlipayDemo]: https://github.com/yangxch/AlipayDemo
[https_github.com_yangxch_AlipayServerAPIDemo]: https://github.com/yangxch/AlipayServerAPIDemo
[https_blog.csdn.net_xch_yang_article_details_86689642]: https://blog.csdn.net/xch_yang/article/details/86689642