8. PHP接入微信的三种支付：APP支付、公众号支付、扫码支付

╰半橙微兮° 2022-07-19 05:58 285阅读 0赞

[payment 项目2.0版本][payment _2.0]

微信的支付逻辑与支付宝的支付有一些差别。为了让客户端忽略这些差别，统一调用。本sdk做了对应处理。

＃ SDK调用

微信支付不同接口需要的参数会有差别。请大家在使用接口时，仔细查看文档。

use Payment\ChargeContext;
    use Payment\Config;
    use Payment\Common\PayException;
    
    // 微信支付，必须设置时区，否则发生错误
    date_default_timezone_set('Asia/Shanghai');
    
    // 生成订单号 便于测试
    function createPayid() { 
        return date('Ymdhis', time()).substr(floor(microtime()*1000),0,1).rand(0,9);
    }
    
    // 订单信息
    $payData = [
        "order_no"  => createPayid(),
        "amount"    => '0.01',// 单位为元 ,最小为0.01
        "client_ip" => '127.0.0.1',
        "subject"   => '测试支付',
        "body"  => '支付接口测试',
        "extra_param"   => '',
    ];
    
    // 微信扫码支付，需要设置的参数
    $payData['product_id']  = '123456';
    
    // 微信公众号支付，需要的参数
    $payData['openid'] = 'otijfvr2oMz3tXnaQdKKbQeeBmhM';// 需要通过微信提供的api获取该openid
    
    /** * 包含客户的配置文件 * 本次 2.0 版本，主要的改变是将配置文件独立出来，便于客户多个账号的情况 * 已经使用不同方式读取配置文件，如：db file cache等 */
    $wxconfig = [
        'app_id'    => 'wxxxx',  // 公众账号ID
        'mch_id'    => 'xxxx',// 商户id
        'md5_key'   => 'xxxxxx',// md5 秘钥
    
        'notify_url'    => 'http://test.helei.com/pay-notify.html',
        'time_expire'   => '14',
    
        // 涉及资金流动时，需要提供该文件
        'cert_path' => dirname(__FILE__) . DIRECTORY_SEPARATOR . 'wx' . DIRECTORY_SEPARATOR . 'apiclient_cert.pem',
        'key_path'  => dirname(__FILE__) . DIRECTORY_SEPARATOR . 'wx' . DIRECTORY_SEPARATOR . 'apiclient_key.pem',
    ];
    
    /** * 实例化支付环境类，进行支付创建 */
    $charge = new ChargeContext();
    
    try {
    
        // 微信 扫码支付
        $type = Config::WX_CHANNEL_QR;
    
        // 微信 APP支付
        //$type = Config::WX_CHANNEL_APP;
    
        // 微信 公众号支付
        //$type = Config::WX_CHANNEL_PUB;
        $charge->initCharge($type, $wxconfig);
        $ret = $charge->charge($payData);
    } catch (PayException $e) {
        echo $e->errorMessage();exit;
    }
    
    if ($type === Config::WX_CHANNEL_QR) {
        $url = urlencode($ret);
        echo "<img alt='扫码支付' src='http://paysdk.weixin.qq.com/example/qrcode.php?data={$url}' style='width:150px;height:150px;'/>";
    } elseif ($type === Config::WX_CHANNEL_PUB) {
        $json = $ret;
        var_dump($json);exit;
    } elseif (stripos($type, 'wx') !== false) {
        var_dump($ret);
    }
    
    ?>

这里扫码支付与公众号支付分别需要提供不同的参数。请一定注意进行区分。否则调用相应端口会抛出异常。

# 配置文件 #

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>是否必须</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>app_id</td> 
   <td>公众账号ID/应用id</td> 
   <td>微信分配的公众账号ID</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>mch_id</td> 
   <td>商户号</td> 
   <td>微信支付分配的商户号</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>md5_key</td> 
   <td>加密的key</td> 
   <td>在商户中心设置</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>notify_url</td> 
   <td>通知地址</td> 
   <td>接收微信支付异步通知回调地址，通知url必须为直接可访问的url，不能携带参数。</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>time_expire</td> 
   <td>交易过期时间</td> 
   <td>单位为分钟，过期后无法再次支付</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>cert_path</td> 
   <td>密钥文件</td> 
   <td>可在微信商户后台中下载</td> 
   <td>否，退款需要</td> 
  </tr> 
  <tr> 
   <td>key_path</td> 
   <td>密钥文件</td> 
   <td>可在商户中心下载</td> 
   <td>否，退款需要</td> 
  </tr> 
 </tbody> 
</table>

这里需要注意的是，app\_id，由于微信的三个支付接口，需要对应两个不同的app\_id。因此再开发中一定要注意。

# 请求参数 #

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>是否必须</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>order_no</td> 
   <td>订单号</td> 
   <td>平台根据规则生成的订单号，最长64位，要在商户数据库中唯一</td> 
   <td>必须</td> 
  </tr> 
  <tr> 
   <td>amount</td> 
   <td>交易总金额</td> 
   <td>该笔订单的资金总额，单位为RMB-Yuan。取值范围为[0.01，100000000.00]，精确到小数点后两位。</td> 
   <td>必须</td> 
  </tr> 
  <tr> 
   <td>client_ip</td> 
   <td>客户端IP</td> 
   <td>用户在创建交易时，该用户当前所使用机器的IP。</td> 
   <td>必须</td> 
  </tr> 
  <tr> 
   <td>subject</td> 
   <td>商品名称</td> 
   <td>商品的标题/交易标题/订单标题/订单关键字等。该参数最长为128个汉字。</td> 
   <td>必须</td> 
  </tr> 
  <tr> 
   <td>body</td> 
   <td>商品描述</td> 
   <td>对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body。</td> 
   <td>必须</td> 
  </tr> 
  <tr> 
   <td>extra_param</td> 
   <td>公用回传参数</td> 
   <td>如果用户请求时传递了该参数，则返回给商户时会回传该参数。</td> 
   <td>可选</td> 
  </tr> 
  <tr> 
   <td>product_id</td> 
   <td>商品ID</td> 
   <td>扫码支付，此参数必传。此id为二维码中包含的商品ID，商户自行定义。</td> 
   <td>可选</td> 
  </tr> 
  <tr> 
   <td>openid</td> 
   <td>用户标识</td> 
   <td>公众号支付，此参数必传，用户在商户appid下的唯一标识。</td> 
   <td>可选</td> 
  </tr> 
 </tbody> 
</table>

# 返回值描述 #

三种支付方式返回值因为处理方式不同，微信方面返回了不同的类型。  
\* app支付返回了需要调用的数组。调用客户端的方式 [查看微信文档][Link 1]  
\* 扫码支付返回了一个地址。可生成一个二维码，完成支付。  
\* 公众号支付，返回的是一个json数据。可直接放入微信的sdk完成jsapi调用。

[payment _2.0]: https://github.com/helei112g/payment/tree/paymentv2
[Link 1]: https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=9_12&index=2