Payment：微信支付发起支付请求文档

以你之姓@ 2022-06-16 23:55 242阅读 0赞

文档更新太慢，自己都忍不住要抱怨了。可能越来越慢了

**`Payment 3.0`** 微信的配置设置文档请 [点击这里][Link 1]

**项目GitHub地址**：[https://github.com/helei112g/payment][https_github.com_helei112g_payment]

为了调用方便，提供了统一的 `Client\Charge` 类来发起支付。需要设置的参数

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>类型</th> 
   <th>是否必须</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>body</td> 
   <td>boolean</td> 
   <td>是</td> 
   <td>商品描述</td> 
  </tr> 
  <tr> 
   <td>subject</td> 
   <td>string</td> 
   <td>是</td> 
   <td>商品名称,该参数最长为128个汉字</td> 
  </tr> 
  <tr> 
   <td>order_no</td> 
   <td>string</td> 
   <td>是</td> 
   <td>商户网站唯一订单号</td> 
  </tr> 
  <tr> 
   <td>timeout_express</td> 
   <td>string</td> 
   <td>是</td> 
   <td>设置未付款交易的超时时间，一旦超时，该笔交易就会自动被关闭。</td> 
  </tr> 
  <tr> 
   <td>amount</td> 
   <td>float</td> 
   <td>是</td> 
   <td>该笔订单的资金总额，单位为RMB-Yuan</td> 
  </tr> 
  <tr> 
   <td>return_param</td> 
   <td>string</td> 
   <td>是</td> 
   <td>附加数据，在查询API和支付通知中原样返回</td> 
  </tr> 
  <tr> 
   <td>client_ip</td> 
   <td>string</td> 
   <td>是</td> 
   <td>用户端实际ip</td> 
  </tr> 
  <tr> 
   <td>terminal_id</td> 
   <td>string</td> 
   <td>是</td> 
   <td>自定义参数，可以为终端设备号(门店号或收银设备ID)，PC网页或公众号内支付可以传”WEB”</td> 
  </tr> 
  <tr> 
   <td>product_id</td> 
   <td>string</td> 
   <td>否</td> 
   <td>商品ID</td> 
  </tr> 
  <tr> 
   <td>openid</td> 
   <td>string</td> 
   <td>否</td> 
   <td>此参数为微信用户在商户对应appid下的唯一标识</td> 
  </tr> 
 </tbody> 
</table>

在上面的参数中，无论微信的哪一种支付都必须提供：  
\- body  
\- subject  
\- order\_no  
\- timeout\_express  
\- amount  
\- return\_param  
\- client\_ip  
\- terminal\_id  
这几个参数，是必须进行设置的。

# 扫码支付 #

用户扫描商户展示在各种场景的二维码进行支付。这里采用的是模式二。

对于扫码支付，必须提供: product\_id 参数，该 `product_id` 是商户自己平台的信息，可用使用sku。

如果扫码支付时，传入了 `openid`，则扫码时，只能使用对应的微信扫码才能完成支付。这里可以根据自己的需求来决定。  
[扫码支付，模式二介绍][Link 2]

# 刷卡支付 #

刷卡支付，就是用于用户向商户展示二维码，商户通过扫码枪获取二维码或者条码信息，完成收款。与上面的扫码支付相对应。  
`auth_code` 是必须设置的参数，扫码支付授权码，设备读取用户微信中的条码或者二维码信息

# app支付 #

适用于商户在移动端APP中集成微信支付功能。  
商户APP调用微信提供的SDK调用微信支付模块，商户APP会跳转到微信中完成支付，支付完后跳回到商户APP内，最后展示支付结果。  
目前微信支付支持手机系统有：IOS（苹果）、Android（安卓）和WP（Windows Phone）。

该支付方式，无需额外的参数信息，只需要上面表格中标记的必须参数。

[客户端教程][Link 3]

# 公众号支付 #

商户已有H5商城网站，用户通过消息或扫描二维码在微信内打开网页时，可以调用微信支付完成下单购买的流程。

这里记住一定时微信内部打开h5页面。

`openid` 是公众号支付必须提供的信息，微信用户在商户对应appid下的唯一标识。openid如何获取，可参考[获取openid][openid]

这里用到了 openid，也就说明该支付只能由发起支付请求的公众号完成支付。

因此，如果有时候遇到：“下单账号和支付账号不一致” ，那么肯定是发起支付请求的时候是一个帐号，而进行支付时变成了另外一个微信帐号导致的。

> 小程序支付与公众号支付具有相同的请求参数

[公众号调起支付][Link 4]  
[小程序调起支付][Link 5]

# h5支付 #

H5支付是指商户在微信客户端外的移动端网页展示商品或服务，用户在前述页面确认使用微信支付时，商户发起本服务呼起微信客户端进行支付。  
主要用于触屏版的手机浏览器请求微信支付的场景。可以方便的从外部浏览器唤起微信支付

微信这个支付能力，并未完全开放，申请的条件也比较苛刻。不过说实话也不好用。

参数跟app支付一样，不需要添加额外的信息。

[外部网页唤起微信支付][Link 6]

# 代码 #

下面代码实例一下

use Payment\Common\PayException;
    use Payment\Client\Charge;
    
    $config = require_once('./wxconfig.php');// 微信的配置信息
    
    
    $channel = 'wx_app';// wx_app wx_pub wx_qr wx_bar wx_lite wx_wap
    
    
    $payData = [
        'body' => '一个苹果',
        'subject' => '牛逼公司--付款吧',
        'order_no' => 'NB12312355',
        'timeout_express' => '1489241888',
        'amount' => '100',
        'return_param' => 'buy some',
        'client_ip' => '127.0.0.1',
        'terminal_id' => 'WEB',
        //'product_id' => '888',
        //'openid' => 'xxxxxxx',
    ];
    // product_id openid 参数，并不是每一个支付都需要，具体行为阅读上面文档
    
    try {
        $str = Charge::run($channel, $config, $payData);
    } catch (PayException $e) {
        // 异常处理
        exit;
    }
    
    if (is_array($ret)) {
        var_dump($ret);
    } else {
        header('Location:' . $ret);
        echo htmlspecialchars($ret);
    }
    exit;

关于 `channel` 的说明：

<table> 
 <thead> 
  <tr> 
   <th>渠道</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>wx_app</td> 
   <td>代表app支付</td> 
  </tr> 
  <tr> 
   <td>wx_pub</td> 
   <td>代表公众号支付</td> 
  </tr> 
  <tr> 
   <td>wx_qr</td> 
   <td>代表扫码支付</td> 
  </tr> 
  <tr> 
   <td>wx_bar</td> 
   <td>代表刷卡支付</td> 
  </tr> 
  <tr> 
   <td>wx_lite</td> 
   <td>代表小程序支付</td> 
  </tr> 
  <tr> 
   <td>wx_wap</td> 
   <td>代表h5支付</td> 
  </tr> 
 </tbody> 
</table>

关于支付返回的各种数据，以及相关支付方式，如果调起微信支付，请自行查看对应文档。

[Link 1]: https://helei112g.github.io/2017/03/28/Payment%EF%BC%9A%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E8%AE%BE%E7%BD%AE%E8%AF%B4%E6%98%8E/
[https_github.com_helei112g_payment]: https://github.com/helei112g/payment
[Link 2]: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_5
[Link 3]: https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=8_5
[openid]: https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_4
[Link 4]: https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6
[Link 5]: https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_7&index=3
[Link 6]: https://pay.weixin.qq.com/wiki/doc/api/H5.php?chapter=15_4