微信小程序支付开发流程教程注意事项及解释，适用于刚接触微信支付，看文档看不清楚

分手后的思念是犯贱 2023-05-31 10:19 5阅读 0赞

##### 本文为自己整理使用，刚开始接触微信小程序中接入微信支付，所以看了一些微信支付的文档，整理了一下。 #####

##### 看了看微信支付的文档，感觉越看越乱，然后就一边看文档一边整理，整理了一下微信小程序接入微信支付的方法，以及一些规则和注意事项。 #####

想要直接查看全部演示代码，查看另一篇文章：  
[https://blog.csdn.net/qq\_32442967/article/details/102727209][https_blog.csdn.net_qq_32442967_article_details_102727209]

#### 一、接口规则 ####

##### 1.协议规则: #####

[https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=4\_1][https_pay.weixin.qq.com_wiki_doc_api_native.php_chapter_4_1]

*  采用HTTPS传输；
 *  post提交；
 *  提交和返回数据都为XML格式，根节点名为xml；
 *  UTF-8；
 *  签名算法 MD5/HMAC-SHA256；
 *  请求和接收数据均需要校验签名：

##### 2.参数规定： #####

[https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=4\_2][https_pay.weixin.qq.com_wiki_doc_api_native.php_chapter_4_2]

简单介绍了几个参数，更多的参数查看微信支付的文档，有详细的介绍

*  交易金额 **total\_fee**：单位为【分】，对账单中的交易金额单位为【元】
 *  交易类型 **trade\_type** ： JSAPI–JSAPI支付（或小程序支付）
 *  时间戳 **timestamp**：自1970年1月1日 0点0分0秒以来的秒数(10位数字)
 *  商户订单号 **out\_trade\_no**：由商户自定义生成；唯一性；
 *  商品描述 **body**： 简单的商品描述

##### 3. 安全规范： #####

###### 3.1、签名算法 ######

[https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=4\_3；][https_pay.weixin.qq.com_wiki_doc_api_native.php_chapter_4_3]  
微信支付接口签名校验工具 [https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=20\_1][https_pay.weixin.qq.com_wiki_doc_api_native.php_chapter_20_1]

**特别注意以下重要规则：**  
◆ 参数名ASCII码从小到大排序（字典序）；  
◆ 如果参数的值为空不参与签名；  
◆ 参数名区分大小写；  
◆ 验证调用返回或微信主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验。  
◆ 微信接口可能增加字段，验证签名时必须支持增加的扩展字段

###### 3.2 生成随机数算法 ######

推荐： 调用随机数函数生成，将得到的值转换为字符串

###### 3.3 API证书 ######

微信支付接口中，涉及资金回滚的接口会使用到API证书，包括退款、撤销接口。  
[https://kf.qq.com/faq/180824JvUZ3i180824YvMNJj.html][https_kf.qq.com_faq_180824JvUZ3i180824YvMNJj.html]

##### 4. 获取openid #####

**openid**是微信用户在公众号appid下的唯一用户标识（appid不同，则获取到的openid就不同），可用于永久标记一个用户，同时也是微信JSAPI支付的必传参数。  
[https://developers.weixin.qq.com/doc/offiaccount/OA\_Web\_Apps/Wechat\_webpage\_authorization.html][https_developers.weixin.qq.com_doc_offiaccount_OA_Web_Apps_Wechat_webpage_authorization.html]

#### 二、api列表 ####

[https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=9\_1][https_pay.weixin.qq.com_wiki_doc_api_native.php_chapter_9_1]

##### 1.统一下单： #####

1.1 **应用场景**：除付款码支付场景以外，商户系统先调用该接口在微信支付服务后台生成预支付交 易单，返回正确的预支付交易会话标识后再按Native、JSAPI、APP等不同场景生成交易串调起支付。  
1.2 **接口链接**  
URL地址：[https://api.mch.weixin.qq.com/pay/unifiedorder][https_api.mch.weixin.qq.com_pay_unifiedorder]  
1.3 **参数值**详见 api列表 文档  
1.4 **返回结果**  
返回状态码：**return\_code**、 返回信息：**return\_msg**

*  return\_code：SUCCESS/FAIL，此字段是通信标识，非交易标识，交易是否成功需要查看result\_code来判断
 *  return\_code 和result\_code都为SUCCESS的时候有返回：业务结果  
    1.5 错误码：err\_code、err\_code\_des 查看文档

##### 2.查询订单： #####

本文中不做过多介绍，主要介绍 **下单支付**

#### 三、开发步骤 ####

##### 1.获取 code #####

**wx.login()** 调用接口获取登录凭证code，用户登录凭证（有效期五分钟）。

wx.login({ 
      success: function (res) { 
        console.log(res.code)
        //调用获取openid方法 2.获取 openid 
      }
    })

##### 2.获取 openid #####

[https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/login/auth.code2Session.html][https_developers.weixin.qq.com_miniprogram_dev_api-backend_open-api_login_auth.code2Session.html]  
开发者需要在开发者服务器后台调用 **auth.code2Session**，使用 code 换取 openid 和 session\_key 等信息  
注：url中的 APPID、SECRET、JSCODE需要替换成自己小程序的值

wx.request({ 
      url: "https://api.weixin.qq.com/sns/jscode2session?appid=APPID&secret=SECRET&js_code=JSCODE&grant_type=authorization_code",
      method: 'GET',
      success: function (res) { 
      	console.log(res.data.openid)	//openid
      	// 调用 统一下单方法 3.统一下单
    	}
    })

##### 3.统一下单 #####

获取 **package** ：统一下单接口返回的 **prepay\_id** 参数值，提交格式如：prepay\_id=\*\*\*

wx.request({ 
      url: 'https://api.mch.weixin.qq.com/pay/unifiedorder',
      method: 'POST',
      head: 'application/x-www-form-urlencoded',
      data: formData, 	//封装统一支付xml参数
      success: function (res) { 
      	console.log(res.data)
      	// 通过 result_code 来判断失败和成功处理方法
      	if(resultCode == 'FAIL'){ 
      		//失败处理 获取错误代码描述 err_code_des
      	}else{ 
      		//成功处理
      		//获取 prepay_id 支付中的 "package": 'prepay_id=' + prepay_id
      		// paySign 签名后的字符串
      		//调用 支付方法 4.发起微信支付
      	}
      }
    })

##### 4.发起微信支付，调用 wx.requestPayment() #####

wx.requestPayment({ 
      timeStamp: '',
      nonceStr: '',
      package: '',
      signType: 'MD5',
      paySign: '',
      success (res) {  },
      fail (res) {  }
    })

[https_blog.csdn.net_qq_32442967_article_details_102727209]: https://blog.csdn.net/qq_32442967/article/details/102727209
[https_pay.weixin.qq.com_wiki_doc_api_native.php_chapter_4_1]: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=4_1
[https_pay.weixin.qq.com_wiki_doc_api_native.php_chapter_4_2]: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=4_2
[https_pay.weixin.qq.com_wiki_doc_api_native.php_chapter_4_3]: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=4_3%EF%BC%9B
[https_pay.weixin.qq.com_wiki_doc_api_native.php_chapter_20_1]: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=20_1
[https_kf.qq.com_faq_180824JvUZ3i180824YvMNJj.html]: https://kf.qq.com/faq/180824JvUZ3i180824YvMNJj.html
[https_developers.weixin.qq.com_doc_offiaccount_OA_Web_Apps_Wechat_webpage_authorization.html]: https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html
[https_pay.weixin.qq.com_wiki_doc_api_native.php_chapter_9_1]: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=9_1
[https_api.mch.weixin.qq.com_pay_unifiedorder]: https://api.mch.weixin.qq.com/pay/unifiedorder
[https_developers.weixin.qq.com_miniprogram_dev_api-backend_open-api_login_auth.code2Session.html]: https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/login/auth.code2Session.html