前言
首先,微信有四种支付方式,如下图所示:
其次,PHP能够实现的只有前三种。因为APP支付很显然是需要iOS和Android来开发的。而本文针对的是公众号支付的PHP开发。
开发步骤
申请微信公众号,这里注意必须是服务号才可以
开通微信支付。微信支付需要相关的企业资质认证。这个流程快的话1天就能下来,慢也不会超过3、4天。微信的员工效率还是很高的。
-
当公众号微信支付开通后,微信会给你的邮箱中发一封邮件。这封邮件内含有以下内容:
你需要登录商户平台进行相关设置,而登陆的账号密码正是邮件中所提供的账号密码。
-
登录商户平台后,第一步需要进行银行账号的绑定验证。第二步则需要你设置API密钥。这个密钥为32位,是之后调用微信支付接口的关键参数之一,如果你不知道怎么生成密匙,可以使用这个密码随机生成器。密钥如果忘记可以重新设置,但是相关的微信支付接口设置也要记得更改。还有就是在API密钥设置界面你还需要下载相关的证书,证书也是微信支付的必要条件之一,这一点之后会详细说明。
-
到了这一步,商户平台的操作就全部完成了。现在需要返回公众号平台,设置测试目录。因为目前只是测试阶段,所以可以不设置正式授权目录,但是注意授权目录不能与测试目录url地址相同。同时请测试人员将自己的微信号加入白名单中。
到此为止,所有的前期准备工作就全部做完了。之后便是真正的代码开发阶段。为了快速了解微信的支付流程,我们可以下载微信支付的官方DEMO。官方DEMO目前支持三种语言,分别是:JAVA、PHP和.NET C#。点击DEMO可以跳转到下载链接。
整个微信公众号支付的流程如下:
用户点击公众号内微信商城打开H5的支付页面
H5页面通过JS调用微信支付接口
微信服务器通过判断输入的JSON数据,返回给客户端相应的成功或失败信息
DEMO
请点击上面提供的连接,下载PHP微信支付的DEMO。解压缩后,我们会看到如下结构的数个PHP文件:
SDK目录结构
|-- cert
| |-- apiclient_cert.pem ----- 微信证书
| `-- apiclient_key.pem ----- 微信证书
|-- index.php ----- 入口
|-- lib ----- 封装好的类(一般不需要动)
| |-- WxPay.Api.php ----- 包括所有微信支付API接口的封装
| |-- WxPay.Config.php ----- 商户配置
| |-- WxPay.Data.php ----- 输入参数封装
| |-- WxPay.Exception.php ----- 异常类
| `-- WxPay.Notify.php ----- 回调通知基类
`-- example ----- DEMO
|-- WxPay.JsApiPay.php ----- 微信公众号支付类
|-- WxPay.MicroPay.php ----- 刷卡支付类
|-- WxPay.NativePay.php ----- 二维码支付类
|-- download.php ----- 下载订单
|-- micropay.php ----- 刷卡支付
|-- native.php ----- 扫码支付
|-- native_notify.php ----- 回调处理(二维码支付)
|-- notify.php ----- 回调处理
|-- orderquery.php ----- 订单查询
|-- qrcode.php ----- 生成二维码
|-- refund.php ----- 订单退款
|-- refundquery.php ----- 退款查询
|-- jsapi.php ----- 公众号支付
|-- log.php ----- 日志
`-- phpqrcode ----- 开源二维码代码
如果仅仅是为了调通微信支付接口的话,我们仅需要修改4个文件:
- cert文件夹中的两个证书替换为我们公众号自己的证书
- 修改
WxPay.Config.php
文件中的参数 - 修改
jsapi.php
文件。该文件甚至不修改也能成功调用接口,但是我们可以在该文件中设置具体支付的金额等订单信息
证书
点击证书下载公众号相关证书。
下载下来的压缩包内一共包含有4个证书:
cert
├── apiclient_cert.p12
├── apiclient_cert.pem
├── apiclient_key.pem
└── rootca.pem
- apiclient_cert.p12是商户证书文件,除PHP外的开发均使用此证书文件。
- 商户如果使用.NET环境开发,请确认Framework版本大于2.0,必须在操作系统上双击安装证书apiclient_cert.p12后才能被正常调用。
- 商户证书调用或安装都需要使用到密码,该密码的值为微信商户号(mch_id)
- PHP开发环境请使用商户证书文件apiclient_cert.pem和apiclient_key.pem ,rootca.pem是CA证书。
这里因为我们使用PHP开发,所以只需要其中的两个证书apiclient_cert.pem
和apiclient_key.pem
。将证书复制粘贴到DEMO的cert文件夹,并替换原有文件即可
WxPay.Config.php 参数配置
代码中的注释写的非常明确,我们只需要设置基本信息中的4个常量即可,其他一般情况下保持默认就行。
<?php
/**
* 配置账号信息
*/
class WxPayConfig
{
//=======【基本信息设置】=====================================
//
/**
* TODO: 修改这里配置为您自己申请的商户信息
* 微信公众号信息配置
*
* APPID:绑定支付的APPID(必须配置,开户邮件中可查看)
*
* MCHID:商户号(必须配置,开户邮件中可查看)
*
* KEY:商户支付密钥,参考开户邮件设置(必须配置,登录商户平台自行设置)
* 设置地址:https://pay.weixin.qq.com/index.php/account/api_cert
*
* APPSECRET:公众帐号secert(仅JSAPI支付的时候需要配置, 登录公众平台,进入开发者中心可设置),
* 获取地址:https://mp.weixin.qq.com/advanced/advanced?action=dev&t=advanced/dev&token=2005451881&lang=zh_CN
* @var string
*/
const APPID = 'wx426b3015555a46be';
const MCHID = '1225312702';
const KEY = 'e10adc3949ba59abbe56e057f20f883e';
const APPSECRET = '01c6d59a3f9024db6336662ac95c8e74';
//=======【证书路径设置】=====================================
/**
* TODO:设置商户证书路径
* 证书路径,注意应该填写绝对路径(仅退款、撤销订单时需要,可登录商户平台下载,
* API证书下载地址:https://pay.weixin.qq.com/index.php/account/api_cert,下载之前需要安装商户操作证书)
* @var path
*/
const SSLCERT_PATH = '../cert/apiclient_cert.pem';
const SSLKEY_PATH = '../cert/apiclient_key.pem';
//=======【curl代理设置】===================================
/**
* TODO:这里设置代理机器,只有需要代理的时候才设置,不需要代理,请设置为0.0.0.0和0
* 本例程通过curl使用HTTP POST方法,此处可修改代理服务器,
* 默认CURL_PROXY_HOST=0.0.0.0和CURL_PROXY_PORT=0,此时不开启代理(如有需要才设置)
* @var unknown_type
*/
const CURL_PROXY_HOST = "0.0.0.0";//"10.152.18.220";
const CURL_PROXY_PORT = 0;//8080;
//=======【上报信息配置】===================================
/**
* TODO:接口调用上报等级,默认紧错误上报(注意:上报超时间为【1s】,上报无论成败【永不抛出异常】,
* 不会影响接口调用流程),开启上报之后,方便微信监控请求调用的质量,建议至少
* 开启错误上报。
* 上报等级,0.关闭上报; 1.仅错误出错上报; 2.全量上报
* @var int
*/
const REPORT_LEVENL = 1;
}
修改 jsapi.php文件
jsapi.php
中代码的工作顺序:
- 页面加载后通过
window.onload = function()
会自动跳转到地址选择页面,并触发editAddress()
事件 - 选择住址后页面返回支付页面,同时弹出警告框显示刚才选择的地址
- 点击支付,触发
callpay()
方法。如果当前浏览器为微信APP,则触发jsApiCall()
方法调用微信支付接口 - 最后是在
notify.php
处理回调通知
注意1:
jsapi.php
原文件中调用的是官方网址的notify.php
文件。你需要改为调用自己服务器上的notify.php
文件,不然无法再log
文件夹中生成相应的日志。而日志会包含两部分:第一条是订单信息,第二条是订单信息加一个额外的trade_state
参数。trade_state
参数如果是success
则表示订单支付成功,其他则失败
注意2:
$input->SetTotal_fee("1")
可以用来设置支付的金额。但是该金额必须为整数。这里的数字1,代表的是金额1分。如果想将金额设置为1元,则需要$input->SetTotal_fee("100")
<?php
ini_set('date.timezone','Asia/Shanghai');
//error_reporting(E_ERROR);
require_once "../lib/WxPay.Api.php";
require_once "WxPay.JsApiPay.php";
require_once 'log.php';
//初始化日志
$logHandler= new CLogFileHandler("../logs/".date('Y-m-d').'.log');
$log = Log::Init($logHandler, 15);
//打印输出数组信息
function printf_info($data)
{
foreach($data as $key=>$value){
echo "<font color='#00ff55;'>$key</font> : $value <br/>";
}
}
//①、获取用户openid
$tools = new JsApiPay();
$openId = $tools->GetOpenid();
//②、统一下单
$input = new WxPayUnifiedOrder();
$input->SetBody("创源测试");
$input->SetAttach("测试attach");
$input->SetOut_trade_no(WxPayConfig::MCHID.date("YmdHis"));
$input->SetTotal_fee("1");
$input->SetTime_start(date("YmdHis"));
$input->SetTime_expire(date("YmdHis", time() + 600));
$input->SetGoods_tag("立减优惠");
$input->SetNotify_url("http://paysdk.weixin.qq.com/example/notify.php");
$input->SetTrade_type("JSAPI");
$input->SetOpenid($openId);
$order = WxPayApi::unifiedOrder($input);
echo '<font color="#f00"><b>统一下单支付单信息</b></font><br/>';
printf_info($order);
$jsApiParameters = $tools->GetJsApiParameters($order);
//获取共享收货地址js函数参数
$editAddress = $tools->GetEditAddressParameters();
//③、在支持成功回调通知中处理成功之后的事宜,见 notify.php
/**
* 注意:
* 1、当你的回调地址不可访问的时候,回调通知会失败,可以通过查询订单来确认支付是否成功
* 2、jsapi支付时需要填入用户openid,WxPay.JsApiPay.php中有获取openid流程 (文档可以参考微信公众平台“网页授权接口”,
* 参考http://mp.weixin.qq.com/wiki/17/c0f37d5704f0b64713d5d2c37b468d75.html)
*/
?>
<html>
<head>
<meta http-equiv="content-type" content="text/html;charset=utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>微信支付样例-支付</title>
<script type="text/javascript">
//调用微信JS api 支付
function jsApiCall()
{
WeixinJSBridge.invoke(
'getBrandWCPayRequest',
<?php echo $jsApiParameters; ?>,
function(res){
WeixinJSBridge.log(res.err_msg);
alert(res.err_code+res.err_desc+res.err_msg);
}
);
}
function callpay()
{
if (typeof WeixinJSBridge == "undefined"){
if( document.addEventListener ){
//从事件冒泡开始执行,也就是从内到外,从小到大开始执行
document.addEventListener('WeixinJSBridgeReady', jsApiCall, false);
}else if (document.attachEvent){
document.attachEvent('WeixinJSBridgeReady', jsApiCall);
document.attachEvent('onWeixinJSBridgeReady', jsApiCall);
}
}else{
jsApiCall();
}
}
</script>
<script type="text/javascript">
//获取共享地址
function editAddress()
{
WeixinJSBridge.invoke(
'editAddress',
<?php echo $editAddress; ?>,
function(res){
var value1 = res.proviceFirstStageName;
var value2 = res.addressCitySecondStageName;
var value3 = res.addressCountiesThirdStageName;
var value4 = res.addressDetailInfo;
var tel = res.telNumber;
//返回所选地址
alert(value1 + value2 + value3 + value4 + ":" + tel);
}
);
}
//进入支付页面后,直接跳转地址选择页面
window.onload = function(){
if (typeof WeixinJSBridge == "undefined"){
if( document.addEventListener ){
document.addEventListener('WeixinJSBridgeReady', editAddress, false);
}else if (document.attachEvent){
document.attachEvent('WeixinJSBridgeReady', editAddress);
document.attachEvent('onWeixinJSBridgeReady', editAddress);
}
}else{
editAddress();
}
};
</script>
</head>
<body>
<br/>
<font color="#9ACD32"><b>该笔订单支付金额为<span style="color:#f00;font-size:50px">1分</span>钱</b></font><br/><br/>
<div align="center">
<button style="width:210px; height:50px; border-radius: 15px;background-color:#FE6714; border:0px #FE6714 solid; cursor: pointer; color:white; font-size:16px;" type="button" onclick="callpay()" >立即支付</button>
</div>
</body>
</html>