扫码支付在中文语境里其实指向**两种完全相反的流程**，选错接口会白折腾一天。先对清楚你要哪个：


|主扫（正扫）|被扫（反扫）|
|:-:|:-:|
|场景|收银台屏幕/小票出二维码，用户拿手机扫|用户亮付款码，商家拿扫码枪扫|
|微信|Native 支付 `v3/pay/transactions/native`|付款码支付 `v3/pay/transactions/micropay`|
|支付宝|`alipay.trade.precreate`（当面付）|`alipay.trade.pay`（scene=bar_code）|
|金额|用户扫码后确认|商家扣款，用户免密|
下面以**主扫（Native + 当面付）**为主线给完整实现，反扫在末尾补差异。


----
## 一、整体链路（两家都一样）

```
[1] 商户后端 ──下单──> 微信/支付宝 ──返回码串(code_url / qr_code)
[2] 后端把码串给前端 ──> 前端用 qrcode.js 渲染成二维码
[3] 用户扫码支付
[4] 支付平台 ──POST 异步通知──> 你的 notify_url ← 状态以此为准
[5] 前端同时轮询 /order/status 做兜底（网络抖动时异步通知可能延迟）
[6] 验签 + 解密 + 幂等落库 → 返回成功应答，否则平台会重推
```
**核心原则：前端跳转/轮询的"成功"都不可信，只有验过签的异步通知才是结算依据。**


----
## 二、微信支付 Native（APIv3）

### 1. 安装与凭证

```php
composer require wechatpay/wechatpay # 官方 SDK，需 PHP >= 7.2.5 + Guzzle 6.5/7.0
composer require endroid/qr-code # 服务端出图才需要；前端渲染可省
```
需要四样东西：商户号 `mchid`、商户 API 私钥 `apiclient_key.pem`、商户证书序列号、APIv3 密钥，外加**微信支付平台证书或微信支付公钥**（PHP-FPM 进程模型下 SDK 不支持自动更新平台证书，得用自带工具下载后放本地）。

### 2. 下单

```php
<?php
// WxPayService.php
require_once __DIR__ . '/vendor/autoload.php';

use WeChatPay\Builder;
use WeChatPay\Crypto\Rsa;
use WeChatPay\Util\PemUtil;

class WxPayService
{
 private $instance;

 public function __construct()
 {
 $merchantPrivateKey = Rsa::from(
 'file:///etc/certs/apiclient_key.pem', Rsa::KEY_TYPE_PRIVATE
 );
 $platformCertPath = 'file:///etc/certs/wechatpay_platform_cert.pem';
 $platformPublicKey = Rsa::from($platformCertPath, Rsa::KEY_TYPE_PUBLIC);

 $this->instance = Builder::factory([
 'mchid' => getenv('WX_MCHID'),
 'serial' => getenv('WX_SERIAL_NO'), // 商户 API 证书序列号
 'privateKey' => $merchantPrivateKey,
 'certs' => [
 PemUtil::parseCertificateSerialNo($platformCertPath) => $platformPublicKey,
 ],
 ]);
 }

 /**
 * Native 下单，返回可直接生成二维码的 code_url
 * @param string $outTradeNo 商户订单号（32 位内，同一号重复下单会报错）
 * @param string $desc 商品描述
 * @param int $amountFen 金额，单位【分】
 */
 public function nativePrepay(string $outTradeNo, string $desc, int $amountFen): string
 {
 $resp = $this->instance
 ->chain('v3/pay/transactions/native')
 ->post(['json' => [
 'appid' => getenv('WX_APPID'),
 'mchid' => getenv('WX_MCHID'),
 'description' => $desc,
 'out_trade_no' => $outTradeNo,
 'notify_url' => 'https://yourdomain.com/pay/wx/notify',
 'amount' => ['total' => $amountFen, 'currency' => 'CNY'],
 ]]);

 $body = json_decode((string) $resp->getBody(), true);
 return $body['code_url']; // 形如 weixin://wxpay/bizpayurl?pr=xxxxx
 }
}
```
注意 `total` 是**整数分**，别把 `9.90` 传进去。

### 3. 渲染二维码

前端渲染更省事（后端只返 `code_url`），用 `qrcodejs` 一行搞定；服务端出图则用 `endroid/qr-code`。无论哪种，`code_url` 有时效（通常 2 小时）且**一码一付**，超时或订单关闭后必须重新下单。

### 4. 异步通知：验签 + 解密 + 幂等

这是最容易写错、也最容易被伪造请求打穿的一环。

```php
<?php
// wx_notify.php
use WeChatPay\Crypto\Rsa;
use WeChatPay\Crypto\AesGcm;
use WeChatPay\Formatter;

$inBody = file_get_contents('php://input'); // 必须拿原始报文，别用 $_POST
$timestamp = $_SERVER['HTTP_WECHATPAY_TIMESTAMP'] ?? '';
$nonce = $_SERVER['HTTP_WECHATPAY_NONCE'] ?? '';
$signature = $_SERVER['HTTP_WECHATPAY_SIGNATURE'] ?? '';
$serialNo = $_SERVER['HTTP_WECHATPAY_SERIAL'] ?? '';

$platformKey = Rsa::from('file:///etc/certs/wechatpay_platform_cert.pem', Rsa::KEY_TYPE_PUBLIC);
$apiv3Key = getenv('WX_APIV3_KEY');

// ① 验签：确认请求确实来自微信
$ok = Rsa::verify(
 Formatter::joinedByLineFeed($timestamp, $nonce, $inBody),
 $signature,
 $platformKey
);
if (!$ok) { http_response_code(401); exit; }

// ② 解密 resource 拿到真实订单数据
$arr = json_decode($inBody, true);
$r = $arr['resource'];
$plain = AesGcm::decrypt($r['ciphertext'], $apiv3Key, $r['nonce'], $r['associated_data']);
$data = json_decode($plain, true);

if ($data['trade_state'] !== 'SUCCESS') {
 echo json_encode(['code' => 'SUCCESS']); // 非成功态也要正常应答，否则会反复重推
 exit;
}

// ③ 幂等：同一 out_trade_no 只处理一次（用 DB 唯一键或 Redis SETNX 挡重）
if (OrderModel::alreadyPaid($data['out_trade_no'])) {
 echo json_encode(['code' => 'SUCCESS']); exit;
}

// ④ 校验金额是否等于本地订单金额 —— 漏了这步等于允许"改价支付"
$order = OrderModel::findByNo($data['out_trade_no']);
if ($order->amount_fen !== (int) $data['amount']['total']) {
 http_response_code(400); exit;
}

OrderModel::markPaid($order, $data['transaction_id']);

// ⑤ 必须返回 2xx + JSON，微信才认为通知成功
echo json_encode(['code' => 'SUCCESS']);
```
### 5. 查单兜底

前端轮询接口里调 `GET /v3/pay/transactions/out-trade-no/{out_trade_no}?mchid=xxx`，以 `trade_state === 'SUCCESS'` 为准：

```php
$resp = $this->instance
 ->chain("v3/pay/transactions/out-trade-no/{$outTradeNo}")
 ->get(['query' => ['mchid' => getenv('WX_MCHID')]]);
```

----
## 三、支付宝当面付（主扫）

支付宝 SDK 现在同时提供 **v2 与 v3 两个版本**，v3 基于 OAS3 规范、JSON 交互、加验签更简洁。新项目建议 v3（`alipaysdk/openapi`），图省事可用 `alipaysdk/easysdk`（v2 封装）。这里给 easysdk 的精简写法。

>⚠️ 一个容易踩的新变化：支付宝官方已将"当面付扫码支付"升级为**订单码支付**，两者调用流程一致，区别只在 `product_code` —— 当面付是 `FACE_TO_FACE_PAYMENT`，订单码支付是 `QR_CODE_OFFLINE`。新接入建议确认当前应签哪个产品。

```php
composer require alipaysdk/easysdk
```
```php
<?php
use Alipay\EasySDK\Kernel\Factory;
use Alipay\EasySDK\Kernel\Config;

function alipayFactory(): void
{
 $config = new Config();
 $config->protocol = 'https';
 $config->gatewayHost = 'openapi.alipay.com'; // 沙箱用 openapi-sandbox.dl.alipaydev.com
 $config->signType = 'RSA2';
 $config->appId = getenv('ALI_APPID');
 $config->merchantPrivateKey = file_get_contents('/etc/certs/app_private_key.pem');
 $config->alipayPublicKey = file_get_contents('/etc/certs/alipay_public_key.pem');
 $config->notifyUrl = 'https://yourdomain.com/pay/ali/notify';
 Factory::setOptions($config);
}

/** 主扫：生成二维码码串 */
function aliPrecreate(string $outTradeNo, string $totalAmount, string $subject): string
{
 alipayFactory();
 $result = Factory::payment()->faceToFace()
 ->preCreate($subject, $outTradeNo, $totalAmount);
 // $totalAmount 单位是【元】，字符串，如 "9.90"
 return $result->qrCode;
}
```
异步通知验签（支付宝的返回体是表单参数，不是 JSON）：

```php
<?php
// ali_notify.php
alipayFactory();
$params = $_POST;

if (!Factory::payment()->common()->verifyNotify($params)) {
 http_response_code(401); exit('fail');
}
if ($params['trade_status'] !== 'TRADE_SUCCESS'
 && $params['trade_status'] !== 'TRADE_FINISHED') {
 exit('success');
}

// 同样要：幂等 + 校验 total_amount 与本地订单一致
OrderModel::markPaid($params['out_trade_no'], $params['trade_no']);

echo 'success'; // 必须原样输出 success，输出其他内容支付宝会持续重发
```

----
## 四、反扫（商家扫用户付款码）的差异

- 微信：`POST /v3/pay/transactions/micropay`，传 `payer.auth_code`（18 位付款码），**同步返回结果**。
- 支付宝：`alipay.trade.pay`，`scene=bar_code` + `auth_code`。
- 关键差异：反扫**没有异步通知**，同步返回就是最终结果。但遇到 `SYSTEMERROR`（微信）/ `USERPAYING`（用户输密码中）不能直接判失败——要**轮询查单**（建议 10 秒一次，30 秒内），仍不明则调撤销订单接口；且撤销必须在扣款后至少 15 秒再调。付款码有效期约 1 分钟，过期要让用户刷新。


----
## 五、上线前必查清单

1. **金额单位**：微信整数分，支付宝字符串元——混用是最高频 bug。
2. **必做验签**：不验签的回调等于把"确认已支付"的权限开放给任何人。
3. **应答格式**：微信要 2xx + `{"code":"SUCCESS"}`，支付宝要纯文本 `success`，写错会被重推 N 次。
4. **幂等**：网络重传 + 平台重推会让同一通知到达多次，用订单号做唯一约束。
5. **金额二次校验**：拿回调里的金额跟本地订单比，防止"一分钱买大件"。
6. **私钥管理**：别硬编码进代码、别进 Git，放服务器安全目录、权限 600，推荐走环境变量或密钥管理服务。
7. **回调必须 HTTPS**​ 且公网可达，本地调试用内网穿透（ngrok/cpolar）。
8. **先跑沙箱**：支付宝有完整沙箱环境，微信支付可用验收用例，别直接拿生产商户号试错。
9. **关单**：二维码超时未付要主动关单（`v3/pay/transactions/out-trade-no/{no}/close`，支付宝 `alipay.trade.close`），避免挂账。
10. **资质门槛**：两家当面付都要求**企业或个体工商户**资质 + 签约开通，个人开发者申请不下来。先确认营业执照和经营场景资料齐了再动手写代码。


----
你现在是打算接**微信还是支付宝**、**主扫还是反扫**？另外项目用的是原生 PHP、Laravel 还是 ThinkPHP？告诉我这三点，我可以直接给你一份贴合框架的完整支付模块（含订单表设计和状态机）。

 推荐查看天气：http://www.362tq.com/baode/
 推荐查看天气：http://www.362tq.com/baode/zuotian.html
 推荐查看天气：http://www.362tq.com/baode/7tian.html
 推荐查看天气：http://www.362tq.com/baode/10tian.html
 推荐查看天气：http://www.362tq.com/baode/15tian.html
 推荐查看天气：http://www.362tq.com/baode/40tian.html
 推荐查看天气：http://www.362tq.com/pianguan/
 推荐查看天气：http://www.362tq.com/pianguan/zuotian.html
 推荐查看天气：http://www.362tq.com/pianguan/7tian.html
 推荐查看天气：http://www.362tq.com/pianguan/10tian.html
 推荐查看天气：http://www.362tq.com/pianguan/15tian.html
 推荐查看天气：http://www.362tq.com/pianguan/40tian.html
 推荐查看天气：http://www.362tq.com/yuanping/
 推荐查看天气：http://www.362tq.com/yuanping/zuotian.html
 推荐查看天气：http://www.362tq.com/yuanping/7tian.html
 推荐查看天气：http://www.362tq.com/yuanping/10tian.html
 推荐查看天气：http://www.362tq.com/yuanping/15tian.html
 推荐查看天气：http://www.362tq.com/yuanping/40tian.html
 推荐查看天气：http://www.362tq.com/linfen/
 推荐查看天气：http://www.362tq.com/linfen/zuotian.html
 推荐查看天气：http://www.362tq.com/linfen/7tian.html
 推荐查看天气：http://www.362tq.com/linfen/10tian.html
 推荐查看天气：http://www.362tq.com/linfen/15tian.html
 推荐查看天气：http://www.362tq.com/linfen/40tian.html
 推荐查看天气：http://www.362tq.com/quwo/
 推荐查看天气：http://www.362tq.com/quwo/zuotian.html
 推荐查看天气：http://www.362tq.com/quwo/7tian.html
 推荐查看天气：http://www.362tq.com/quwo/10tian.html
 推荐查看天气：http://www.362tq.com/quwo/15tian.html
 推荐查看天气：http://www.362tq.com/quwo/40tian.html
 推荐查看天气：http://www.362tq.com/linfenyicheng/
 推荐查看天气：http://www.362tq.com/linfenyicheng/zuotian.html
 推荐查看天气：http://www.362tq.com/linfenyicheng/7tian.html
 推荐查看天气：http://www.362tq.com/linfenyicheng/10tian.html
 推荐查看天气：http://www.362tq.com/linfenyicheng/15tian.html
 推荐查看天气：http://www.362tq.com/linfenyicheng/40tian.html
 推荐查看天气：http://www.362tq.com/xiangfen/
 推荐查看天气：http://www.362tq.com/xiangfen/zuotian.html
 推荐查看天气：http://www.362tq.com/xiangfen/7tian.html
 推荐查看天气：http://www.362tq.com/xiangfen/10tian.html
 推荐查看天气：http://www.362tq.com/xiangfen/15tian.html
 推荐查看天气：http://www.362tq.com/xiangfen/40tian.html
 推荐查看天气：http://www.362tq.com/hongdong/
 推荐查看天气：http://www.362tq.com/hongdong/zuotian.html
 推荐查看天气：http://www.362tq.com/hongdong/7tian.html
 推荐查看天气：http://www.362tq.com/hongdong/10tian.html
 推荐查看天气：http://www.362tq.com/hongdong/15tian.html
 推荐查看天气：http://www.362tq.com/hongdong/40tian.html
 推荐查看天气：http://www.362tq.com/guxian/
 推荐查看天气：http://www.362tq.com/guxian/zuotian.html
 推荐查看天气：http://www.362tq.com/guxian/7tian.html
 推荐查看天气：http://www.362tq.com/guxian/10tian.html
 推荐查看天气：http://www.362tq.com/guxian/15tian.html
 推荐查看天气：http://www.362tq.com/guxian/40tian.html
 推荐查看天气：http://www.362tq.com/anze/
 推荐查看天气：http://www.362tq.com/anze/zuotian.html
 推荐查看天气：http://www.362tq.com/anze/7tian.html
 推荐查看天气：http://www.362tq.com/anze/10tian.html
 推荐查看天气：http://www.362tq.com/anze/15tian.html
 推荐查看天气：http://www.362tq.com/anze/40tian.html
 推荐查看天气：http://www.362tq.com/linfenfushan/
 推荐查看天气：http://www.362tq.com/linfenfushan/zuotian.html
 推荐查看天气：http://www.362tq.com/linfenfushan/7tian.html
 推荐查看天气：http://www.362tq.com/linfenfushan/10tian.html
 推荐查看天气：http://www.362tq.com/linfenfushan/15tian.html
 推荐查看天气：http://www.362tq.com/linfenfushan/40tian.html
 推荐查看天气：http://www.362tq.com/linfenjixian/
 推荐查看天气：http://www.362tq.com/linfenjixian/zuotian.html
 推荐查看天气：http://www.362tq.com/linfenjixian/7tian.html
 推荐查看天气：http://www.362tq.com/linfenjixian/10tian.html
 推荐查看天气：http://www.362tq.com/linfenjixian/15tian.html
 推荐查看天气：http://www.362tq.com/linfenjixian/40tian.html
 推荐查看天气：http://www.362tq.com/xiangning/
 推荐查看天气：http://www.362tq.com/xiangning/zuotian.html
 推荐查看天气：http://www.362tq.com/xiangning/7tian.html
 推荐查看天气：http://www.362tq.com/xiangning/10tian.html
 推荐查看天气：http://www.362tq.com/xiangning/15tian.html
 推荐查看天气：http://www.362tq.com/xiangning/40tian.html
 推荐查看天气：http://www.362tq.com/daning/
 推荐查看天气：http://www.362tq.com/daning/zuotian.html
 推荐查看天气：http://www.362tq.com/daning/7tian.html
 推荐查看天气：http://www.362tq.com/daning/10tian.html
 推荐查看天气：http://www.362tq.com/daning/15tian.html
 推荐查看天气：http://www.362tq.com/daning/40tian.html
 推荐查看天气：http://www.362tq.com/linfenxixian/
 推荐查看天气：http://www.362tq.com/linfenxixian/zuotian.html
 推荐查看天气：http://www.362tq.com/linfenxixian/7tian.html
 推荐查看天气：http://www.362tq.com/linfenxixian/10tian.html
 推荐查看天气：http://www.362tq.com/linfenxixian/15tian.html
 推荐查看天气：http://www.362tq.com/linfenxixian/40tian.html
 推荐查看天气：http://www.362tq.com/yonghe/
 推荐查看天气：http://www.362tq.com/yonghe/zuotian.html
 推荐查看天气：http://www.362tq.com/yonghe/7tian.html
 推荐查看天气：http://www.362tq.com/yonghe/10tian.html
 推荐查看天气：http://www.362tq.com/yonghe/15tian.html
 推荐查看天气：http://www.362tq.com/yonghe/40tian.html
 推荐查看天气：http://www.362tq.com/puxian/
 推荐查看天气：http://www.362tq.com/puxian/zuotian.html
 推荐查看天气：http://www.362tq.com/puxian/7tian.html
 推荐查看天气：http://www.362tq.com/puxian/10tian.html

扫码支付在中文语境里其实指向两种完全相反的流程，选错接口会白折腾一天。先对清楚你要哪个：

PHP怎么实现扫码支付功能

人工智能

主扫与反扫是两种相反扫码支付流程，选错接口白折腾一天。微信Native支付与支付宝当面付实现步骤、异步通知验签解密、幂等落库、金额二次校验及反扫差异全解析，附PHP代码示例与上线必查清单，避坑指南助你快速接入。

代码解释

密钥管理

服务器

Kernel

JSON

2026上云采购 | AI焕新·智启新局

cpay

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

PHP怎么实现扫码支付功能-腾讯云开发者社区-腾讯云

PHP怎么实现扫码支付功能

PHP怎么实现扫码支付功能

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐