微信小程序开发实战11_1 微信支付下单_不允许携带查询串

微信支付流程图

微信支付存在多个业务流程，包括微信支付流程、退款流程等。本章节主要介绍微信的支付下单流程，图12-1是微信支付流程的交互图：

重点环节说明

• 步骤1：小程序端用户向商户服务器发起支付请求，重点是提供用户信息、商品信息、支付金额等参数。
• 步骤3：商户服务器调用支付统一下单接口生成微信支付订单，调用成功后返回预支付交易会话标识（prepay_id），该参数将用于小程序前端的接口调用。
• 步骤6：获取prepay_id后，需要再次签名，然后把签名参数以及prepay_id等参数返回给小程序。
• 步骤9：小程序调用接口：wx.requestPayment调起微信支付，发起支付请求。
• 步骤15：用户支付成功后，商户服务器可接收到微信支付支付结果通知，商户服务器收到通知后更新订单的支付状态。
• 步骤20：商户在没有接收到微信支付结果通知的情况下需要主动调用查询订单API查询支付结果。

12.1提交支付订单

商户系统调用该接口生成预支付交易单。提交支付订单的请求URL为：
https://api.mch.weixin.qq.com/v3/pay/partner/transactions/jsapi
提交支付订单的接口的请求参数如下：

调用成功后返回：预支付交易会话标识（prepay_id），该参数用于小程序前端的接口调用中，该值的有效期为2小时。以下是实现提交支付订单的代码逻辑，首先给出的是统一下接口使用的数据结构：

//订单数据
type WxAppOrderData struct {
   //子商户用ID（服务商）
   Sub_appid          string `json:"sub_appid,omitempty"`
   //子商户的商户号（服务商）
   Sub_mchid          string `json:"sub_mchid,omitempty"`
   //商品描述
   Description        string `json:"description"`
   //商户系统内部订单号
   Out_trade_no       string `json:"out_trade_no"`
   //交易结束时间
   Time_expire        string `json:"time_expire,omitempty"`
   //附加数据，在查询API和支付通知中原样返回，可作为自定义参数使用
   Attach                string `json:"attach,omitempty"`
   //通知URL必须为直接可访问的URL，不允许携带查询串
   Notify_url           string `json:"notify_url"`
   //订单优惠标记
   Goods_tag          string `json:"goods_tag,omitempty"`
   //订单金额信息
   Amount OrderCreateAmount      `json:"amount"`
   //支付者信息
   Payer OrderPayer            `json:"payer"`
   //统一下单结算信息
   Settle_info OrderCreateSettle  `json:"settle_info"`
}

//统一下单请求参数
type WxAppOrderCreateReq struct {
   //应用ID(普通商户)
   Appid             string `json:"appid,omitempty"`
   //直连商户号(普通商户)
   Mchid                 string `json:"mchid,omitempty"`
   //服务商用ID（服务商）
   Sp_appid              string `json:"sp_appid,omitempty"`
   //服务商户号（服务商）
   Sp_mchid           string `json:"sp_mchid,omitempty"`
   //订单数据
   WxAppOrderData
}

//统一下单返回参数
type WxAppOrderCreateRet struct {
   //详细错误码
   Return_code       string     `json:"code"`
   //错误描述
   Return_msg        string     `json:"message"`
   //预支付交易会话标识。用于后续接口调用中使用，该值有效期为2小时
   Prepay_id         string     `json:"prepay_id"`
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

微信支付为直连商户模式以及服务商模式提供了不同的调用接口（具有不同的接口地址以及请求参数）。本文中直连商户模式以及服务商模式共用一套数据结构，并通过json的omitempty标签来适应两种模式的区别。接下来给出服务商模式下接口调用的实现逻辑：

//支付统一下单
//data:支付订单信息
func (ent *MchWxapp) createOrderX(data WxAppOrderData) (WxAppPayParam, error)  {
   var preq WxAppOrderCreateReq
   preq.Sp_appid = ent.Appid
   preq.Sp_mchid = ent.Mchid
   preq.WxAppOrderData = data
   data_body, _ := json.Marshal(preq)

   var param_ent WxAppPayParam
   var pret WxAppOrderCreateRet
   const url = "https://api.mch.weixin.qq.com/v3/pay/partner/transactions/jsapi"
   result, err := WxPayPostV3((*MchParam)(ent), url, data_body)
   if err != nil {
      return param_ent, err
   }
   err = json.Unmarshal([]byte(result), &pret)
   if err != nil {
      fmt.Println(err)
      return param_ent, err
   }
   if pret.Prepay_id == "" {
      return param_ent, errors.New(pret.Return_msg)
   }

   //小程序客户端支付参数
   param_ent.Appid = preq.Sub_appid
   param_ent.TimeStamp = fmt.Sprintf("%d", time.Now().Unix())
   param_ent.NonceStr, _= GenerateNonce()
   param_ent.Prepay_id = pret.Prepay_id
   param_ent.Package = "prepay_id=" + pret.Prepay_id
   param_ent.SignType = "RSA"
   param_ent.PaySign, _ = param_ent.GenPaySignV3(ent.MchPrivateKey)
   return param_ent, nil
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

通过JSAPI下单成功获取预支付交易会话标识（prepay_id）后，需要通过小程序调用支付API（wx.requestPayment）来拉起微信客户端进行支付。wx.requestPayment需要将请求参数进行签名，签名计算的逻辑如下：
1）构造签名串
签名串一共有四行，每一行为一个参数。行尾以\n结束，包括最后一行。参与签名字段及格式为：
小程序appId\n时间戳\n随机字符串\n订单详情扩展字符串\n
2）计算签名值
使用商户私钥对签名串进行SHA256 with RSA签名，并对签名结果进行Base64编码得到签名值。
接下来给出小程序参数签名计算的实现代码，首先给出返回给小程序所需的支付数据的数据结构：

type WxAppPayParam struct{
   Appid string
   TimeStamp string
   NonceStr string
   Prepay_id string
   Package string
   SignType string
   PaySign string
}
1
2
3
4
5
6
7
8
9

接下来使用商户私钥对签名串进行SHA256 with RSA签名，并对签名结果进行Base64编码来计算签名值：

func (ent *WxAppPayParam)GenPaySignV3(mch_pem_key *rsa.PrivateKey) (string, error) {
   SignatureMessageFormat := "%s\n%s\n%s\n%s\n"
   message := fmt.Sprintf(SignatureMessageFormat, ent.Appid, ent.TimeStamp, ent.NonceStr, ent.Package)
   signatureResult, err := SignSHA256WithRSA(mch_pem_key, message)
   if err != nil {
      return "", err
   }
   return signatureResult, nil
}
1
2
3
4
5
6
7
8
9

直连商户的下单接口与服务商下单接口基本一致，除了接口地址不同外，下单时不需要提供子商户号（sub_mchid）， 也不需要提供子商户子商户的应用ID（sub_appid）。直连商户下单接口的请求URL为：
https://api.mch.weixin.qq.com/v3/pay/transactions/jsapi
直连商户下单接口的请求参数如下：

以下是直连商户下单接口访问的代码实现：

func (ent *MchWxapp) createOrder(data WxAppOrderData) (WxAppPayParam, error)  {
   var preq WxAppOrderCreateReq
   preq.Appid = ent.Appid
   preq.Mchid = ent.Mchid
   preq.WxAppOrderData = data
   data_body, _ := json.Marshal(preq)

   var param_ent WxAppPayParam
   var pret WxAppOrderCreateRet
   const url = "https://api.mch.weixin.qq.com/v3/pay/transactions/jsapi"
   result, err := WxPayPostV3((*MchParam)(ent), url, data_body)
   if err != nil {
      return param_ent, err
   }

   err = json.Unmarshal([]byte(result), &pret)
   if err != nil {
      return param_ent, err
   }

   if pret.Prepay_id == "" {
      return param_ent, errors.New(pret.Return_msg)
   }

   //小程序客户端支付参数
   param_ent.Appid = preq.Appid
   param_ent.TimeStamp = fmt.Sprintf("%d", time.Now().Unix())
   param_ent.NonceStr, _= GenerateNonce()
   param_ent.Prepay_id = pret.Prepay_id
   param_ent.Package = "prepay_id=" + pret.Prepay_id
   param_ent.SignType = "RSA"
   param_ent.PaySign, _ = param_ent.GenPaySignV3(ent.MchPrivateKey)
   return param_ent, nil
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34