技术 · 思考 · 实践 · 成长

首页/微信小程序/正文

微信小程序生产级商品支付全流程:下单、调起、回调、查单与退款

微信小程序9 次阅读

微信小程序商品支付看似只需要调用一次 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 发送异步通知。生产处理顺序必须是:

  1. 读取原始 HTTP 请求体和签名相关请求头;
  2. 使用微信支付公钥或平台证书验证通知签名;
  3. 用 API v3 密钥对 resource 执行 AES-256-GCM 解密;
  4. 校验 appid、mchid、out_trade_no、金额和币种;
  5. 在数据库事务中执行幂等状态变更;
  6. 提交成功后返回 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 时,仍要走与回调相同的金额校验和幂等入账方法,不能另写一套宽松逻辑。

十八、超时订单与关单

业务订单超过支付时间后,先查询微信侧状态:

  1. 如果已支付成功,按成功订单补单;
  2. 如果仍是 NOTPAY,调用关单接口;
  3. 微信确认关单后,再释放库存并把本地状态改为 CLOSED;
  4. 如果状态不确定,进入人工或补偿队列,不能贸然释放权益。
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. 1 分钱真实支付并验证回调、查单和对账字段。
  2. 连续点击支付按钮,确认只产生可控的订单和支付单。
  3. 支付中断网、杀进程、切后台,确认能够自动补单。
  4. 重复发送相同回调,确认不会重复发货或加权益。
  5. 篡改客户端金额、openid、order_no,确认服务端拒绝。
  6. 模拟回调签名错误、金额不一致和未知订单。
  7. 验证超时查单、关单和库存释放。
  8. 测试全额退款、部分退款、重复退款和退款回调。
  9. 轮换验签公钥或平台证书,验证平滑更新能力。
  10. 检查日志脱敏、告警、限流、数据库备份和应急手册。
  11. 核对商户平台订单、业务订单、支付记录和资金账单。

二十七、推荐实施顺序

  1. 先完成商品、订单、库存和金额计算的领域模型。
  2. 接入微信登录,稳定保存用户 openid。
  3. 使用官方 SDK 完成 API v3 下单与调起签名。
  4. 优先完成安全的回调验签、解密和幂等入账。
  5. 增加主动查单、超时关单和异常补偿。
  6. 完成退款、退款通知与售后状态机。
  7. 最后补齐监控、对账、密钥轮换和灾难恢复演练。

二十八、官方文档

二十九、总结

生产级微信小程序支付不是“调起支付按钮”这么简单,而是一套以服务端订单为核心的资金状态系统。安全实现必须做到:服务端计价、API v3 签名、通知验签解密、金额与身份核对、订单幂等、主动查单、超时关单、退款闭环和异常补偿。只有把客户端成功提示与最终资金状态分离,并建立完整状态机和监控对账,商品支付流程才能真正稳定上线。

你努力了什么,也就成就了什么,与其羡慕别人,不如蜕变自己。

评论交流

0 条评论 · 支持多级回复
验证码
暂无评论,来说说你的想法吧

相关文章

继续阅读