feat: 收银台支持支付宝支付（微信/支付宝选择器）

PC 收银台此前硬编码「请使用微信扫码支付」，只能走微信 Native。改动： - 支付方式选择器（微信支付 / 支付宝），切换即重新发起支付并清掉上一张码—— 同一订单号换支付类型重复下单会被渠道拒（微信回 OUT_TRADE_NO_USED），两种支付信息同时留在页面上只会让用户困惑。 - 支付宝走电脑网站支付：后端返回自提交表单，用 document.write 写进新窗口。刻意不用 v-html——它插入的脚本标签不会执行（HTML 规范如此），表单永远不会自动提交。原收银台页留在原标签页继续轮询查单。 - 弹窗被拦截时给出可行动提示，并保留「前往支付宝付款」按钮兜底。 - 回到一张曾用支付宝发起过的待支付订单时，默认选中支付宝，避免又拿微信去撞一次「订单号已使用」。 - useHjcPayStatus 增加 channel 参数，仅供提示文案说对「微信侧/支付宝侧」。 **状态词表不变**——后端已把两个渠道的状态映射成渠道无关的 PaymentStatus，前端再加一份支付宝词表等于把渠道知识泄漏进 UI。顺带把这层理由写进注释。 - 修正代码注释里对 ADR 0009 的引用：工作区 docs/adr 下并没有这一篇，相关决策现记录在 ADR 0008。验证：eslint 0 error；npm run build:dev 构建通过。
2026-09-20 19:18:02 +08:00
parent 0d6410c17f
commit 31f2f07c5c
4 changed files with 232 additions and 110 deletions
@@ -35,27 +35,68 @@

    <!-- 待支付：进入即自动发起支付（与购标流程的支付步骤、h5 收银台一致） -->
    <div v-else class="mx-auto mt-6 max-w-2xl rounded-lg border border-gray-200 p-8 text-center">
-      <h2 class="text-xl font-bold text-gray-900">请使用微信扫码支付</h2>
+      <h2 class="text-xl font-bold text-gray-900">请使用{{ channelLabel }}支付</h2>
      <p class="mt-2 text-sm text-gray-500">订单号：{{ orderNo }}</p>
      <p class="mt-1 text-sm text-gray-500">{{ order?.projectName }}</p>
      <!-- 金额一律来自**订单本身**（by-no），不来自支付响应：
           支付一失败页面就会停在 0.00，而收银台恰恰是最需要看到金额的地方 -->
      <p class="my-4 text-2xl font-bold text-blue-600">¥{{ formatMoney(amount) }}</p>

-      <template v-if="codeUrl">
+      <!--
+        支付方式选择。**切换方式即重新发起支付**——同一订单号不能换支付类型重复下单
+        （微信会回 OUT_TRADE_NO_USED），所以切换前把上一张码清掉，避免两张码同时留在页面上。
+      -->
+      <div class="mb-6 inline-flex rounded-md border border-gray-200 p-1">
+        <button
+          v-for="opt in payOptions"
+          :key="opt.value"
+          type="button"
+          class="rounded px-4 py-1.5 text-sm font-medium transition-colors disabled:opacity-50"
+          :class="payType === opt.value
+            ? 'bg-blue-600 text-white'
+            : 'text-gray-600 hover:bg-gray-50'"
+          :disabled="starting || refreshing"
+          @click="switchPayType(opt.value)"
+        >
+          {{ opt.label }}
+        </button>
+      </div>
+
+      <!-- 支付宝网页支付：后端返回一段自提交表单，写进新页面即跳转账单 -->
+      <template v-if="alipayForm">
+        <div class="rounded-md bg-blue-50 px-4 py-6 text-sm text-blue-700">
+          已为你打开支付宝收银台。若新页面没有自动打开，请点击下方按钮。
+        </div>
+        <button
+          class="mt-6 w-full rounded-md bg-blue-600 py-3 font-medium text-white hover:bg-blue-700 disabled:opacity-50"
+          :disabled="confirming"
+          @click="openAlipayForm"
+        >
+          {{ confirming ? '确认中...' : '前往支付宝付款' }}
+        </button>
+        <button
+          class="mt-3 w-full rounded-md border border-gray-300 py-3 font-medium text-gray-700 hover:bg-gray-50 disabled:opacity-50"
+          :disabled="confirming"
+          @click="confirmPaid"
+        >
+          {{ confirming ? '确认中...' : '我已完成支付，确认订单' }}
+        </button>
+      </template>
+
+      <template v-else-if="codeUrl">
        <!-- 过期只是置灰提示，仍留在页面上：万一用户是刚过点就扫的，还能看见自己扫的是哪张码 -->
        <div :class="payExpired ? 'opacity-30' : ''">
-          <HjcPayQrcode :value="codeUrl" :size="240" />
+          <HjcPayQrcode :value="codeUrl" :size="240" :alt="qrAlt" />
        </div>
-        <p class="mt-3 text-sm text-gray-500">请在 2 小时内用微信扫描上方二维码完成支付</p>
+        <p class="mt-3 text-sm text-gray-500">请在 2 小时内用{{ channelLabel }}扫描上方二维码完成支付</p>
        <p v-if="payExpired" class="mt-2 text-sm text-amber-600">二维码已过期，请重新获取后再扫码</p>
      </template>
      <div v-else class="rounded-md bg-gray-50 px-4 py-6 text-sm text-gray-500">
-        {{ starting ? '正在获取支付二维码...' : '暂未获取到支付二维码，请点击下方按钮重新获取' }}
+        {{ starting ? `正在获取${channelLabel}支付` : '暂未获取到支付信息，请点击下方按钮重新获取' }}
      </div>

      <button
-        v-if="codeUrl"
+        v-if="codeUrl && !alipayForm"
        class="mt-6 w-full rounded-md bg-blue-600 py-3 font-medium text-white hover:bg-blue-700 disabled:opacity-50"
        :disabled="confirming"
        @click="confirmPaid"
@@ -63,6 +104,7 @@
        {{ confirming ? '确认中...' : '我已完成支付，确认订单' }}
      </button>
      <button
+        v-if="!alipayForm"
        class="mt-6 w-full rounded-md py-3 font-medium disabled:opacity-50"
        :class="codeUrl
          ? 'border border-gray-300 text-gray-700 hover:bg-gray-50'
@@ -70,7 +112,7 @@
        :disabled="refreshing || starting"
        @click="refreshQr"
      >
-        {{ (refreshing || starting) ? '获取中...' : (codeUrl ? '重新获取二维码' : '获取支付二维码') }}
+        {{ (refreshing || starting) ? '获取中...' : (codeUrl ? '重新获取二维码' : '获取支付信息') }}
      </button>

      <p v-if="error || payError" class="mt-3 text-sm text-red-500">{{ error || payError }}</p>
@@ -93,8 +135,8 @@ import { hjcOrderStatusKey } from '~/utils/orderStatus'
 * 收银台是事后回到某张待支付订单继续付款。**本轮不重构 BuyDocument**，
 * 两份实现共享的只有 `HjcPayQrcode` 与 `useHjcPayStatus`（重活已经都在那里了）。
 *
- * 本页**只服务微信外**（ADR 0009）：恒走 Native 扫码。不要在这里加"微信 UA 就跳 hjc-h5"，
- * 那条链在 .scratch/hjc-web-pay-qrcode/issues/06 里被"hjc-h5 上线"阻塞着。
+ * 本页只服务微信外（ADR 0008）：不因 UA 在微信内就跳 hjc-h5。
+ * 支付方式可选**微信扫码**或**支付宝**；支付宝走电脑网站支付（返回自提交表单）。
 */
 const route = useRoute()
 const { isLoggedIn, handleAuthCode } = useHjcAuth()
@@ -112,16 +154,29 @@ const order = shallowRef<any | null>(null)
 /** 终态（已完成/已取消/已退款）：终态下**绝不发起支付** */
 const finalState = shallowRef<{ title: string; cls: string } | null>(null)

+/** 当前支付方式。默认微信，与接入支付宝之前的行为一致 */
+const payType = ref<'wechat' | 'alipay'>('wechat')
+const payOptions = [
+  { value: 'wechat' as const, label: '微信支付' },
+  { value: 'alipay' as const, label: '支付宝' }
+]
+
 const codeUrl = ref('')
+/** 支付宝电脑网站支付的自提交表单 */
+const alipayForm = ref('')
 const amount = ref(0)
 const starting = ref(false)
 const refreshing = ref(false)
 const confirming = ref(false)
 const error = ref('')

+/** 提示文案里的渠道名（只影响措辞，不影响判定） */
+const channelLabel = computed(() => (payType.value === 'alipay' ? '支付宝' : '微信'))
+const qrAlt = computed(() => (payType.value === 'alipay' ? '支付宝支付二维码' : '微信支付二维码'))
+
 /**
- * 支付确认一律以**微信侧**为准（轮询 + 手动按钮都走它）。
- * 绝不调用 `mark-paid`：那个接口不查单，点一下就能把订单置为已支付（见 ADR 0009）。
+ * 支付确认一律以**渠道侧**为准（轮询 + 手动按钮都走它）。
+ * 绝不调用 `mark-paid`：那个接口不查单，点一下就能把订单置为已支付（见 ADR 0008）。
 */
 const {
  paid,
@@ -130,9 +185,9 @@ const {
  expired: payExpired,
  start: startPayPolling,
  query: queryPayStatus
-} = useHjcPayStatus(() => route.fullPath)
+} = useHjcPayStatus(() => route.fullPath, () => payType.value)

-// 微信侧确认收款后跳订单列表（与 h5 收银台的 redirectTo 列表对齐）
+// 渠道侧确认收款后跳订单列表（与 h5 收银台的 redirectTo 列表对齐）
 watch(paid, async (v) => {
  if (v) await navigateTo('/tender/orders')
 })
@@ -156,12 +211,12 @@ function terminalStateOf(o: any) {
 }

 /**
- * 微信错误码 → 可行动的中文提示。
+ * 渠道错误码 → 可行动的中文提示。
 *
 * `OUT_TRADE_NO_USED` = 同一订单号换了支付类型重复下单。微信内（h5 → 小程序，JSAPI）与
 * PC 端（Native）各发起一次时必现，而"从订单列表回到旧单支付"这条路径正是本轮新开的。
- * 错误码由后端从支付异常的 cause 链上取（`ServiceException.getErrorCode()`），
- * 前端**不要**去匹配 message 字符串——那种写法会在错误包装方式一改时静默失效。
+ * 错误码由后端从支付异常的 cause 链上取，前端**不要**去匹配 message 字符串——
+ * 那种写法会在错误包装方式一改时静默失效。
 */
 function payErrorMessage(res: any) {
  if (res?.data?.wechatCode === 'OUT_TRADE_NO_USED') {
@@ -174,7 +229,10 @@ async function startPay() {
  error.value = ''
  starting.value = true
  try {
-    const res: any = await $fetch('/api/tender/pay', { method: 'POST', body: { orderNo: orderNo.value } })
+    const res: any = await $fetch('/api/tender/pay', {
+      method: 'POST',
+      body: { orderNo: orderNo.value, payType: payType.value }
+    })
    const auth = await handleAuthCode(res, route.fullPath)
    if (auth.handled) {
      error.value = auth.message || ''
@@ -182,12 +240,18 @@ async function startPay() {
    }
    if (res?.code === 0) {
      codeUrl.value = res.data?.codeUrl || ''
+      alipayForm.value = res.data?.alipayForm || ''
      if (res.data?.amount) amount.value = Number(res.data.amount)
-      if (!codeUrl.value) error.value = '未获取到支付二维码，请稍后重试'
+      if (!codeUrl.value && !alipayForm.value) {
+        error.value = '未获取到支付信息，请稍后重试'
+      } else if (alipayForm.value) {
+        // 网页支付：立刻把表单送去新页面，用户不必再点一次
+        openAlipayForm()
+      }
    } else {
      error.value = payErrorMessage(res)
    }
-    // 无论这次有没有拿到支付码都开始查单：订单可能**已经**在微信侧付过了
+    // 无论这次有没有拿到支付码都开始查单：订单可能**已经**在渠道侧付过了
    //（例如在微信内由小程序付掉、或上一次支付成功但页面被关掉），查单会把它认出来并跳列表。
    if (orderNo.value) startPayPolling(orderNo.value)
  } catch (e: any) {
@@ -197,12 +261,45 @@ async function startPay() {
  }
 }

-/** 重新获取二维码：微信允许对同一订单号重复发起 Native 下单，顺带重置 2 小时计时 */
+/**
+ * 把支付宝返回的自提交表单写进一个新页面。
+ *
+ * 用 `document.write` 而不是 `v-html`：表单里带一段自动提交的脚本，
+ * 而 `v-html` 插入的脚本标签**不会执行**（HTML 规范如此），表单永远不会自动提交。
+ * 写进新窗口则脚本正常执行，且原收银台页面保留在原标签页继续轮询查单。
+ *
+ * 注意：本注释不要写出脚本标签的字面量——SFC 的 script 块会被它提前闭合。
+ */
+function openAlipayForm() {
+  if (!alipayForm.value) return
+  const w = window.open('', '_blank')
+  if (!w) {
+    // 弹窗被拦截：留在本页提示用户点按钮重试（按钮复用它）
+    error.value = '浏览器拦截了新窗口，请允许弹出窗口后点「前往支付宝付款」'
+    return
+  }
+  w.document.open()
+  w.document.write(alipayForm.value)
+  w.document.close()
+  error.value = ''
+}
+
+/** 切换支付方式：清掉上一张码再重新发起，避免两种支付信息同时留在页面上 */
+async function switchPayType(next: 'wechat' | 'alipay') {
+  if (next === payType.value) return
+  payType.value = next
+  codeUrl.value = ''
+  alipayForm.value = ''
+  error.value = ''
+  await startPay()
+}
+
+/** 重新获取二维码：允许对同一订单号重复发起下单，顺带重置计时 */
 async function refreshQr() {
  await startPay()
 }

-/** 手动确认（扫码后的兜底）：**也走查单**，不代替微信下结论 */
+/** 手动确认（扫码后的兜底）：**也走查单**，不代替渠道下结论 */
 async function confirmPaid() {
  error.value = ''
  confirming.value = true
@@ -216,7 +313,7 @@ async function confirmPaid() {
      await navigateTo('/tender/orders')
      return
    }
-    error.value = res.message || '微信侧还未收到付款，请完成扫码支付后再试'
+    error.value = res.message || `${channelLabel.value}侧还未收到付款，请完成支付后再试`
  } finally {
    confirming.value = false
  }
@@ -250,6 +347,11 @@ onMounted(async () => {
      finalState.value = terminal
      return
    }
+    // 已在这张单上发起过支付宝支付，就默认用支付宝继续——避免用户上次选了支付宝、
+    // 这次进来又被默认拉回微信，撞一次渠道侧的「订单号已使用」
+    if (typeof o?.payMethod === 'string' && o.payMethod.startsWith('ALIPAY')) {
+      payType.value = 'alipay'
+    }
    // 只有"确实还没付、也没取消"才发起支付
    loading.value = false
    await startPay()