微信小程序商品支付看似只需要调用一次 wx.requestPayment,但生产系统真正需要处理的是完整交易链路:商品价格校验、创建本地订单、微信支付 API v3 下单、小程序调起收银台、支付通知验签与解密、订单幂等更新、主动查单、超时关单以及退款。任何一步处理不当,都可能造成重复支付、虚假支付、漏单或资损。
本文以“普通商户 + 微信支付 API v3 + PHP 服务端”为例,给出一套可落地的生产级实现思路。示例中的商户号、证书序列号、密钥和域名均为占位符,不能直接用于真实环境。
一、生产级支付架构
小程序客户端
│ 1. 登录并选择商品
▼
业务服务端
│ 2. 查询商品真实价格、创建本地订单
│ 3. 调用 /v3/pay/transactions/jsapi
▼
微信支付
│ 4. 返回 prepay_id
▼
业务服务端
│ 5. 生成小程序调起支付签名
▼
小程序客户端
│ 6. wx.requestPayment 调起收银台
▼
微信支付
│ 7. 异步发送支付结果通知
▼
业务服务端
│ 8. 验签、解密、核对金额、幂等更新订单
▼
发货/权益服务
最重要的原则是:客户端传来的商品名称、价格、订单状态和支付结果都不可信。金额必须由服务端根据商品与促销规则重新计算,最终支付成功必须以微信支付通知或服务端主动查单结果为准。
二、接入前准备
正式开发前需要准备:
- 已认证的微信小程序及 AppID;
- 微信支付商户号 mchid,并完成 AppID 与商户号绑定;
- 开通 JSAPI/小程序支付权限;
- 商户 API 私钥和对应证书序列号;
- 32 字节 API v3 密钥,用于解密回调资源;
- 微信支付公钥或平台证书,用于验证微信应答和通知签名;
- 可通过公网 HTTPS 访问的支付与退款通知地址。
小程序支付与 JSAPI 支付共用下单接口 POST /v3/pay/transactions/jsapi,但小程序通过 wx.requestPayment 调起收银台。
三、配置与密钥管理
敏感配置只能保存在服务端环境变量、密钥管理服务或受控配置文件中,不能写进小程序代码、Git 仓库或前端接口响应。
WECHAT_APP_ID=wx1234567890abcdef
WECHAT_MCH_ID=1900000001
WECHAT_MCH_SERIAL_NO=7777777777777777777777777777777777777777
WECHAT_MCH_PRIVATE_KEY_PATH=/secure/wechat/apiclient_key.pem
WECHAT_PAY_PUBLIC_KEY_ID=PUB_KEY_ID_01111111111111111111111111111111
WECHAT_PAY_PUBLIC_KEY_PATH=/secure/wechat/wechatpay_public_key.pem
WECHAT_API_V3_KEY=0123456789abcdef0123456789abcdef
WECHAT_PAY_NOTIFY_URL=https://api.example.com/api/pay/wechat/notify
WECHAT_REFUND_NOTIFY_URL=https://api.example.com/api/pay/wechat/refund-notify
私钥文件应限制操作系统读取权限,并制定轮换和备份方案。日志中不得输出私钥、API v3 密钥、完整 Authorization 头、用户 openid 或回调明文中的敏感字段。
四、订单和支付表设计
商品订单与支付尝试建议分表保存,避免一个业务订单多次发起支付时覆盖历史记录。
CREATE TABLE shop_order (
id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
order_no VARCHAR(32) NOT NULL COMMENT '商户业务订单号',
user_id BIGINT UNSIGNED NOT NULL,
status VARCHAR(24) NOT NULL DEFAULT 'PENDING_PAY',
total_amount INT UNSIGNED NOT NULL COMMENT '应付金额,单位分',
paid_amount INT UNSIGNED DEFAULT NULL COMMENT '实付金额,单位分',
paid_at DATETIME DEFAULT NULL,
expire_at DATETIME NOT NULL,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (id),
UNIQUE KEY uk_order_no (order_no),
KEY idx_user_created (user_id, created_at),
KEY idx_status_expire (status, expire_at)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE shop_order_item (
id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
order_id BIGINT UNSIGNED NOT NULL,
product_id BIGINT UNSIGNED NOT NULL,
sku_id BIGINT UNSIGNED NOT NULL,
product_name VARCHAR(200) NOT NULL COMMENT '下单快照',
unit_price INT UNSIGNED NOT NULL COMMENT '单价,单位分',
quantity INT UNSIGNED NOT NULL,
subtotal INT UNSIGNED NOT NULL COMMENT '小计,单位分',
PRIMARY KEY (id),
KEY idx_order_id (order_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE payment_record (
id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
order_id BIGINT UNSIGNED NOT NULL,
out_trade_no VARCHAR(32) NOT NULL COMMENT '商户支付单号',
transaction_id VARCHAR(64) DEFAULT NULL COMMENT '微信支付订单号',
appid VARCHAR(32) NOT NULL,
mchid VARCHAR(32) NOT NULL,
openid VARCHAR(128) NOT NULL,
amount_total INT UNSIGNED NOT NULL COMMENT '支付金额,单位分',
status VARCHAR(24) NOT NULL DEFAULT 'NOTPAY',
prepay_id VARCHAR(128) DEFAULT NULL,
success_time DATETIME DEFAULT NULL,
notify_id VARCHAR(64) DEFAULT NULL,
raw_notify JSON DEFAULT NULL,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (id),
UNIQUE KEY uk_out_trade_no (out_trade_no),
UNIQUE KEY uk_transaction_id (transaction_id),
UNIQUE KEY uk_notify_id (notify_id),
KEY idx_order_id (order_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE refund_record (
id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
order_id BIGINT UNSIGNED NOT NULL,
out_refund_no VARCHAR(32) NOT NULL,
refund_id VARCHAR(64) DEFAULT NULL,
refund_amount INT UNSIGNED NOT NULL,
total_amount INT UNSIGNED NOT NULL,
status VARCHAR(24) NOT NULL DEFAULT 'PROCESSING',
success_time DATETIME DEFAULT NULL,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (id),
UNIQUE KEY uk_out_refund_no (out_refund_no),
UNIQUE KEY uk_refund_id (refund_id),
KEY idx_order_id (order_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
所有金额都使用整数“分”,避免浮点数精度问题。商品名称、单价等要写入订单快照,防止商品后续改价影响历史订单。
五、订单状态机
PENDING_PAY 待支付
├── 支付成功 ──> PAID ──> FULFILLING ──> COMPLETED
├── 用户取消 ──> CANCELLED
└── 超时关单 ──> CLOSED
PAID / COMPLETED
└── 申请退款 ──> REFUNDING ──> PART_REFUNDED / REFUNDED
状态变更必须有明确方向,不能让客户端随意传入目标状态。每次变更可增加订单事件表,记录操作来源、原状态、新状态、业务流水号和时间,便于审计与排错。
六、小程序登录并取得 openid
小程序先调用 wx.login() 获取一次性 code,再把 code 发送到业务服务端。服务端调用微信登录接口换取 openid,并建立自己的登录会话。
wx.login({
success(res) {
if (!res.code) {
wx.showToast({ title: '登录失败,请重试', icon: 'none' })
return
}
wx.request({
url: 'https://api.example.com/api/auth/wechat-login',
method: 'POST',
data: { code: res.code },
success(loginRes) {
wx.setStorageSync('access_token', loginRes.data.access_token)
}
})
}
})
AppSecret 只能由服务端使用,不能放在小程序包中。服务端应把 openid 与内部 user_id 绑定,后续创建支付订单时从登录会话读取,而不是相信客户端提交的 openid。
七、客户端提交商品,不提交可信金额
async function createOrder() {
const result = await request('/api/orders', 'POST', {
items: [
{ sku_id: 10001, quantity: 2 },
{ sku_id: 10008, quantity: 1 }
],
coupon_id: 3002,
address_id: 9008,
request_token: generateRequestToken()
})
return result.order_no
}
客户端只提交 SKU、数量、优惠券和地址等业务选择。服务端必须重新查询商品状态、库存、限购、优惠规则与真实价格,计算订单金额。request_token 用于防止用户重复点击创建多张业务订单。
八、服务端创建业务订单
public function createOrder(Request $request)
{
$userId = $request->user()->id;
$items = $request->post('items/a', []);
$requestToken = $request->post('request_token');
// 1. 使用 userId + requestToken 做幂等检查
// 2. 从数据库查询 SKU,不接受客户端价格
// 3. 校验上架状态、库存、限购和优惠券
// 4. 使用整数分计算总金额
// 5. 在事务中写入订单、明细及库存预占
return json([
'order_no' => $orderNo,
'amount' => $totalAmount,
'expire_at' => $expireAt,
]);
}
订单号应由服务端生成并保证唯一,可使用日期、节点号和随机序列组合。不要直接使用数据库自增 ID 作为对外支付单号,也不要在重试时随意更换同一次支付的 out_trade_no。
九、调用微信支付 API v3 下单
普通商户小程序支付使用:
POST https://api.mch.weixin.qq.com/v3/pay/transactions/jsapi
请求体示例:
{
"appid": "wx1234567890abcdef",
"mchid": "1900000001",
"description": "商城商品订单",
"out_trade_no": "P202611160001ABCDEF",
"time_expire": "2026-11-16T15:30:00+08:00",
"attach": "shop-order",
"notify_url": "https://api.example.com/api/pay/wechat/notify",
"amount": {
"total": 19900,
"currency": "CNY"
},
"payer": {
"openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
}
}
生产系统应使用微信支付官方 SDK 处理请求签名、应答验签和证书轮换,不建议自行拼装底层密码学代码。下单成功后保存返回的 prepay_id。预支付标识存在有效期,过期后应查询原订单状态,再使用相同业务信息重新获取,而不是创建不可控的新订单。
十、API v3 请求签名原理
理解签名结构有助于排查错误。商户请求签名串由以下内容按顺序拼接,每行以换行符结束:
HTTP请求方法\n
URL路径和查询参数\n
时间戳\n
随机字符串\n
请求报文主体\n
使用商户 API 私钥以 SHA256-RSA 签名,再组成 Authorization 请求头。签名时的 URL 必须与实际请求路径和查询参数完全一致,JSON 请求体也必须与最终发送的字节内容一致。
常见签名失败原因包括:
- 证书序列号与私钥不匹配;
- 服务器时间偏差过大;
- 签名后又修改了 JSON 或 URL;
- 遗漏末尾换行符;
- 把平台证书私钥与商户私钥混淆;
- 商户号与 AppID 未正确绑定。
十一、生成小程序调起支付参数
服务端取得 prepay_id 后,生成给 wx.requestPayment 使用的二次签名。签名原文为:
appId\n
timeStamp\n
nonceStr\n
package\n
其中 package 的值为 prepay_id=实际预支付ID。
function buildMiniProgramPayParams(
string $appId,
string $prepayId,
string $merchantPrivateKeyPem
): array {
$timeStamp = (string) time();
$nonceStr = bin2hex(random_bytes(16));
$package = 'prepay_id=' . $prepayId;
$message = $appId . "\n"
. $timeStamp . "\n"
. $nonceStr . "\n"
. $package . "\n";
openssl_sign(
$message,
$signature,
$merchantPrivateKeyPem,
OPENSSL_ALGO_SHA256
);
return [
'timeStamp' => $timeStamp,
'nonceStr' => $nonceStr,
'package' => $package,
'signType' => 'RSA',
'paySign' => base64_encode($signature),
];
}
推荐仍由官方 SDK 生成调起参数。服务端返回给小程序的字段只包括调起支付所需参数,不返回私钥、API v3 密钥或商户敏感配置。
十二、小程序调用 wx.requestPayment
async function payOrder(orderNo) {
if (this.data.paying) return
this.setData({ paying: true })
try {
const payParams = await request(
`/api/orders/${orderNo}/payment`,
'POST',
{}
)
await new Promise((resolve, reject) => {
wx.requestPayment({
timeStamp: payParams.timeStamp,
nonceStr: payParams.nonceStr,
package: payParams.package,
signType: payParams.signType,
paySign: payParams.paySign,
success: resolve,
fail: reject
})
})
// success 只表示客户端调起流程返回成功,仍需向服务端查订单
const order = await request(`/api/orders/${orderNo}`, 'GET')
wx.redirectTo({ url: `/pages/order/detail?order_no=${order.order_no}` })
} catch (error) {
const cancelled = String(error.errMsg || '').includes('cancel')
wx.showToast({
title: cancelled ? '已取消支付' : '支付未完成,请稍后重试',
icon: 'none'
})
} finally {
this.setData({ paying: false })
}
}
按钮必须防重复点击。客户端 success 回调不能作为发货依据,fail 也不等于订单一定未支付,例如客户端断网时服务端可能已经收到成功通知。
十三、支付结果通知处理
微信支付会向 notify_url 发送异步通知。生产处理顺序必须是:
- 读取原始 HTTP 请求体和签名相关请求头;
- 使用微信支付公钥或平台证书验证通知签名;
- 用 API v3 密钥对 resource 执行 AES-256-GCM 解密;
- 校验 appid、mchid、out_trade_no、金额和币种;
- 在数据库事务中执行幂等状态变更;
- 提交成功后返回 HTTP 200 或 204。
回调头部通常包含:
Wechatpay-Timestamp
Wechatpay-Nonce
Wechatpay-Signature
Wechatpay-Serial
验签原文由时间戳、随机串和原始请求体组成。必须保留原始 body,不能先 JSON 解码再重新编码后验签。
十四、AES-256-GCM 解密回调资源
function decryptWechatResource(array $resource, string $apiV3Key): array
{
$ciphertextWithTag = base64_decode($resource['ciphertext'], true);
if ($ciphertextWithTag === false || strlen($ciphertextWithTag) < 16) {
throw new RuntimeException('Invalid ciphertext');
}
$ciphertext = substr($ciphertextWithTag, 0, -16);
$tag = substr($ciphertextWithTag, -16);
$plaintext = openssl_decrypt(
$ciphertext,
'aes-256-gcm',
$apiV3Key,
OPENSSL_RAW_DATA,
$resource['nonce'],
$tag,
$resource['associated_data'] ?? ''
);
if ($plaintext === false) {
throw new RuntimeException('Wechat resource decrypt failed');
}
return json_decode($plaintext, true, 512, JSON_THROW_ON_ERROR);
}
这段代码只演示解密步骤,不能替代通知验签。必须先确认通知确实来自微信,再解密和处理业务。
十五、回调业务校验
解密得到支付结果后,至少核对:
if ($data['trade_state'] !== 'SUCCESS') {
throw new RuntimeException('Trade is not successful');
}
if ($data['appid'] !== config('wechat.app_id')) {
throw new RuntimeException('AppID mismatch');
}
if ($data['mchid'] !== config('wechat.mch_id')) {
throw new RuntimeException('Merchant ID mismatch');
}
if ((int) $data['amount']['total'] !== $payment->amount_total) {
throw new RuntimeException('Payment amount mismatch');
}
if (($data['amount']['currency'] ?? 'CNY') !== 'CNY') {
throw new RuntimeException('Currency mismatch');
}
还应确认 out_trade_no 对应本地支付记录,openid 与订单用户一致,transaction_id 未绑定到其他订单。任何关键字段不一致都不能直接标记支付成功,应记录安全告警并人工处理。
十六、支付回调幂等处理
微信可能重复发送同一通知,网络重试也可能让多个进程同时处理。推荐在事务中锁定支付记录:
Db::startTrans();
try {
$payment = Db::name('payment_record')
->where('out_trade_no', $data['out_trade_no'])
->lock(true)
->find();
if (!$payment) {
throw new RuntimeException('Payment record not found');
}
if ($payment['status'] === 'SUCCESS') {
Db::commit();
return response('', 204);
}
// 再次核对商户号、AppID、金额、币种和 openid
Db::name('payment_record')
->where('id', $payment['id'])
->update([
'status' => 'SUCCESS',
'transaction_id' => $data['transaction_id'],
'success_time' => parseWechatTime($data['success_time']),
'notify_id' => $notifyId,
'raw_notify' => json_encode($data, JSON_UNESCAPED_UNICODE),
]);
Db::name('shop_order')
->where('id', $payment['order_id'])
->where('status', 'PENDING_PAY')
->update([
'status' => 'PAID',
'paid_amount' => (int) $data['amount']['total'],
'paid_at' => parseWechatTime($data['success_time']),
]);
// 写入 outbox/event 表,提交后由异步任务发货
Db::commit();
return response('', 204);
} catch (Throwable $e) {
Db::rollback();
logger()->error('wechat_pay_notify_failed', ['error' => $e->getMessage()]);
return response('', 500);
}
发货、发券、增加会员权益等耗时操作不应直接阻塞回调。可在同一事务写入事件表,再由消息队列或定时任务异步执行,并为权益发放设置独立幂等键。
十七、为什么必须主动查单
回调可能因为网络、证书或程序故障延迟。以下场景应主动查询微信支付订单:
- 客户端支付返回后,本地订单仍是待支付;
- 订单接近过期但未收到通知;
- 回调处理异常,需要补偿;
- 客服处理支付争议;
- 定时任务扫描长时间处于 NOTPAY 的订单。
按商户订单号查询:
GET /v3/pay/transactions/out-trade-no/{out_trade_no}?mchid={mchid}
查询结果为 SUCCESS 时,仍要走与回调相同的金额校验和幂等入账方法,不能另写一套宽松逻辑。
十八、超时订单与关单
业务订单超过支付时间后,先查询微信侧状态:
- 如果已支付成功,按成功订单补单;
- 如果仍是 NOTPAY,调用关单接口;
- 微信确认关单后,再释放库存并把本地状态改为 CLOSED;
- 如果状态不确定,进入人工或补偿队列,不能贸然释放权益。
POST /v3/pay/transactions/out-trade-no/{out_trade_no}/close
不要只根据本地 expire_at 直接关闭订单。可能存在“客户端已付款、回调尚未送达”的时间窗口。
十九、退款流程
退款必须由经过授权的服务端操作触发,小程序不能直接决定退款金额。申请退款接口:
POST /v3/refund/domestic/refunds
{
"out_trade_no": "P202611160001ABCDEF",
"out_refund_no": "R202611160001XYZ123",
"reason": "用户申请退货",
"notify_url": "https://api.example.com/api/pay/wechat/refund-notify",
"amount": {
"refund": 5000,
"total": 19900,
"currency": "CNY"
}
}
退款前应查询支付状态并校验可退金额。申请接口返回成功只代表微信已受理,不代表资金已经退回。最终结果应以退款通知或退款查询为准。
退款幂等规则:
- 同一次退款重试必须使用相同的 out_refund_no;
- 部分退款每次使用不同 out_refund_no;
- 累计退款金额不能超过用户实际支付金额;
- 退款状态更新和售后状态更新必须放在受控事务中;
- 退款通知同样需要验签、解密、核对金额并幂等处理。
二十、接口设计建议
| 接口 | 作用 | 关键控制 |
|---|---|---|
POST /api/orders | 创建业务订单 | 登录、服务端计价、库存与请求幂等 |
POST /api/orders/{no}/payment | 创建/复用支付单 | 订单归属、状态、金额、防重复 |
GET /api/orders/{no} | 查询订单 | 只能查询自己的订单 |
POST /api/pay/wechat/notify | 支付通知 | 验签、解密、金额核对、幂等 |
POST /api/admin/orders/{no}/refund | 申请退款 | 后台权限、审批、退款幂等 |
POST /api/pay/wechat/refund-notify | 退款通知 | 验签、解密、金额核对、幂等 |
二十一、并发与库存一致性
支付成功不代表库存处理可以随意进行。常见方案是下单时预占库存,订单超时后释放,支付成功后转为正式扣减。
UPDATE product_sku
SET available_stock = available_stock - :quantity,
locked_stock = locked_stock + :quantity
WHERE id = :sku_id
AND available_stock >= :quantity;
必须检查受影响行数。支付成功后的库存确认、发货和权益发放都应具备幂等性。若使用消息队列,建议采用事务消息或 Outbox Pattern,避免数据库已提交但消息未发送。
二十二、异常与补偿机制
生产系统需要定时任务扫描异常状态:
- 待支付超过一定时间:查单后关单或补单;
- 微信成功、本地未成功:执行幂等补单;
- 本地 PAID 但权益未发放:重新投递履约事件;
- 退款 PROCESSING 时间过长:主动查询退款状态;
- 金额或身份不一致:冻结自动处理并触发安全告警;
- 回调持续失败:告警并保留可重放的原始请求信息。
补偿任务必须调用与正常回调相同的领域服务,保证校验规则和幂等逻辑一致。
二十三、安全要求
- 所有接口使用 HTTPS,小程序后台配置合法 request 域名。
- 服务端独立计算价格,客户端金额只用于展示。
- 商户私钥、API v3 密钥和 AppSecret 永不下发客户端。
- 所有微信应答和通知都按官方规范验签。
- 回调解密后核对 appid、mchid、订单号、openid、金额和币种。
- 订单查询必须校验登录用户与订单归属关系。
- 退款接口放在受控后台,配置权限、审批和审计日志。
- 支付接口增加限流、防重放、请求 ID 和结构化审计日志。
- 服务器使用 NTP 同步时间,避免签名时间戳异常。
- 依赖官方 SDK 并及时跟进安全升级和证书轮换。
二十四、日志与监控
每次支付链路应有统一 trace_id,并记录:
- order_no、out_trade_no、transaction_id;
- 调用接口、HTTP 状态、微信错误码和耗时;
- 订单原状态与新状态;
- 回调通知 ID、验签结果和幂等命中情况;
- 主动查单、关单、退款和补偿结果。
监控指标至少包括支付下单成功率、调起失败率、支付成功率、回调失败率、回调延迟、查单补单数量、退款失败率和订单金额差异告警。日志必须脱敏,不能记录密钥、签名原文中的敏感数据或完整个人信息。
二十五、常见问题
1. 商户下单提示 AppID 与商户号不匹配
检查商户平台是否已绑定当前小程序 AppID,以及配置使用的 mchid、appid 是否属于同一接入关系。
2. wx.requestPayment 提示签名错误
检查 appId、timeStamp 字符串、nonceStr、package 和末尾换行符,确认 package 格式为 prepay_id=...,并使用与证书序列号对应的商户私钥。
3. 客户端显示支付成功,但订单仍待支付
客户端 success 不是最终依据。服务端应主动查单,同时检查回调 URL、验签、解密、数据库事务和响应状态码。
4. 支付回调收到多次
这是需要预期的正常情况。使用唯一索引、行锁和状态判断实现幂等,已成功处理的通知直接返回 200 或 204。
5. 用户取消支付如何处理
保留订单为待支付并允许在有效期内重新支付,或由用户主动取消。不要因为客户端返回 cancel 就立即认定微信侧绝对未支付。
6. 支付金额使用元还是分
API v3 金额字段使用整数分。数据库也建议统一保存分,页面展示时再格式化为元。
7. 退款接口返回成功,为什么还没到账
申请成功只表示受理,应等待退款通知或主动查询退款状态,最终到账时间还取决于原支付渠道。
二十六、上线前测试清单
- 1 分钱真实支付并验证回调、查单和对账字段。
- 连续点击支付按钮,确认只产生可控的订单和支付单。
- 支付中断网、杀进程、切后台,确认能够自动补单。
- 重复发送相同回调,确认不会重复发货或加权益。
- 篡改客户端金额、openid、order_no,确认服务端拒绝。
- 模拟回调签名错误、金额不一致和未知订单。
- 验证超时查单、关单和库存释放。
- 测试全额退款、部分退款、重复退款和退款回调。
- 轮换验签公钥或平台证书,验证平滑更新能力。
- 检查日志脱敏、告警、限流、数据库备份和应急手册。
- 核对商户平台订单、业务订单、支付记录和资金账单。
二十七、推荐实施顺序
- 先完成商品、订单、库存和金额计算的领域模型。
- 接入微信登录,稳定保存用户 openid。
- 使用官方 SDK 完成 API v3 下单与调起签名。
- 优先完成安全的回调验签、解密和幂等入账。
- 增加主动查单、超时关单和异常补偿。
- 完成退款、退款通知与售后状态机。
- 最后补齐监控、对账、密钥轮换和灾难恢复演练。
二十八、官方文档
二十九、总结
生产级微信小程序支付不是“调起支付按钮”这么简单,而是一套以服务端订单为核心的资金状态系统。安全实现必须做到:服务端计价、API v3 签名、通知验签解密、金额与身份核对、订单幂等、主动查单、超时关单、退款闭环和异常补偿。只有把客户端成功提示与最终资金状态分离,并建立完整状态机和监控对账,商品支付流程才能真正稳定上线。