refactor: 微信支付命名从 Native 改为 PC扫码,统一术语

- WxpayNativeOrderParams → WxpayPcOrderParams
- createNativeOrder → createPcOrder
- 文档注释统一为「PC扫码 / H5」
This commit is contained in:
erio
2026-03-06 14:31:43 +08:00
parent b0f1daf469
commit cba8acdd60
4 changed files with 7 additions and 6 deletions

View File

@@ -37,7 +37,7 @@ EASY_PAY_RETURN_URL="https://pay.example.com/pay/result"
# ALIPAY_RETURN_URL=https://pay.example.com/pay/result
# ── 微信支付直连PAYMENT_PROVIDERS 含 wxpay 时必填) ────────────────────
# 前端自动检测设备类型PC 端使用 Native 扫码支付,移动端使用 H5 跳转微信 APP 支付
# 前端自动检测设备类型PC 端扫码支付,移动端 H5 跳转微信 APP 支付
# 不在 PAYMENT_PROVIDERS 中配置 wxpay 则不启用微信支付
# WXPAY_APP_ID= # 公众号或移动应用 AppID
# WXPAY_MCH_ID= # 商户号10位数字

View File

@@ -1,6 +1,6 @@
import WxPay from 'wechatpay-node-v3';
import { getEnv } from '@/lib/config';
import type { WxpayNativeOrderParams, WxpayH5OrderParams, WxpayRefundParams } from './types';
import type { WxpayPcOrderParams, WxpayH5OrderParams, WxpayRefundParams } from './types';
const BASE_URL = 'https://api.mch.weixin.qq.com';
@@ -76,7 +76,8 @@ async function request<T>(method: string, url: string, body?: Record<string, unk
return data as T;
}
export async function createNativeOrder(params: WxpayNativeOrderParams): Promise<string> {
/** PC 扫码支付(微信官方 API: /v3/pay/transactions/native */
export async function createPcOrder(params: WxpayPcOrderParams): Promise<string> {
const env = assertWxpayEnv(getEnv());
const result = await request<{ code_url: string }>('POST', '/v3/pay/transactions/native', {
appid: env.WXPAY_APP_ID,

View File

@@ -9,7 +9,7 @@ import type {
RefundResponse,
} from '@/lib/payment/types';
import {
createNativeOrder,
createPcOrder,
createH5Order,
queryOrder,
closeOrder,
@@ -49,7 +49,7 @@ export class WxpayProvider implements PaymentProvider {
return { tradeNo: request.orderId, payUrl: h5Url };
}
const codeUrl = await createNativeOrder({
const codeUrl = await createPcOrder({
out_trade_no: request.orderId,
description: request.subject,
notify_url: notifyUrl,

View File

@@ -1,4 +1,4 @@
export interface WxpayNativeOrderParams {
export interface WxpayPcOrderParams {
out_trade_no: string;
description: string;
notify_url: string;