php实现小程序支付完整版

小程序支付概述

小程序支付是微信生态中常见的支付功能，用户无需跳转App即可完成支付，PHP作为后端开发语言，常用于处理支付逻辑、与微信支付API交互及订单管理，实现小程序支付需涉及小程序前端、PHP后端及微信支付接口的协同工作，核心流程包括生成支付参数、调起支付、回调处理及订单状态更新。

微信支付准备工作

在开始开发前，需完成以下准备工作：

1. 注册小程序：通过微信公众平台注册小程序，获取AppID。
2. 开通支付功能：在微信商户平台开通小程序支付，获取商户号（mch_id）、API密钥（key）等敏感信息。
3. 配置域名：在微信公众平台配置合法的支付回调域名，确保后端接口可被微信服务器访问。
4. 安装依赖：PHP项目中需安装微信支付SDK（如wechatpay-php），简化API调用流程。

生成支付参数的PHP实现

小程序支付需通过后端生成预支付交易单，步骤如下：

1. 构造请求参数：包括appid、mch_id、body（商品描述）、out_trade_no（商户订单号）、total_fee（金额）、spbill_create_ip（用户IP）等字段。
2. 生成签名：使用MD5或HMAC-SHA1算法对参数签名，确保数据安全性。
3. 调用统一下单API：通过POST请求向微信支付接口提交数据，获取预支付ID（prepay_id）。
4. 返回小程序所需参数：将prepay_id、时间戳、随机数及签名组装为JSON格式，返回给前端。

// 示例代码片段
$params = [
    'appid' => 'your_appid',
    'mch_id' => 'your_mch_id',
    'nonce_str' => md5(time()),
    'body' => '商品名称',
    'out_trade_no' => 'ORDER' . time(),
    'total_fee' => 100, // 单位：分
    'spbill_create_ip' => $_SERVER['REMOTE_ADDR'],
    'trade_type' => 'JSAPI'
];
$params['sign'] = generateSign($params); // 生成签名
$xml = arrayToXml($params); // 转换为XML格式
$response = curlPost('https://api.mch.weixin.qq.com/pay/unifiedorder', $xml);
$prepayId = simplexml_load_string($response)->prepay_id;

小程序前端调起支付

前端获取支付参数后，通过wx.requestPayment调起微信支付：

wx.requestPayment({
  timeStamp: String(Date.now()),
  nonceStr: 'random_str',
  package: 'prepay_id=' + prepayId,
  signType: 'MD5',
  paySign: res.data.sign, // 后端返回的签名
  success: function(res) { /* 支付成功回调 */ },
  fail: function(res) { /* 支付失败处理 */ }
});

支付结果处理与订单管理

微信支付完成后，会通过异步回调通知后端支付结果，PHP需处理以下逻辑：

1. 接收回调数据：解析微信服务器发送的XML或JSON数据，包括out_trade_no、transaction_id及result_code等字段。
2. 验证签名：再次校验回调数据的签名，防止伪造请求。
3. 更新订单状态：根据支付结果（成功/失败）更新数据库中的订单状态，如将订单标记为“已支付”或“支付失败”。
4. 返回响应：向微信服务器返回SUCCESS或FAIL，确保回调不被重复发送。

// 回调处理示例
$notifyData = file_get_contents('php://input');
$xml = simplexml_load_string($notifyData);
if ($xml->return_code == 'SUCCESS' && verifySign($xml)) {
    // 更新订单逻辑
    echo 'SUCCESS';
} else {
    echo 'FAIL';
}

常见问题与解决方案

1. 签名错误：检查API密钥是否正确，参数是否按字典序排序。
2. 预支付ID为空：确认商户号是否开通支付功能，域名是否已配置。

相关问答FAQs

Q1：小程序支付时提示“无效的商户号”怎么办？
A1：请检查商户号是否在微信支付平台正确配置，且小程序与商户号的绑定关系是否生效，登录微信商户平台核对商户号信息，并确保小程序已关联该商户。

Q2：支付回调如何防止重复通知？
A2：在回调处理中，根据out_trade_no查询订单状态，若订单已处理则直接返回SUCCESS，避免重复执行业务逻辑,记录回调日志便于排查问题。