NomadVIP | 异度星球

NomadVIP 前端（Next.js App Router），负责会员购买、支付跳转、支付状态轮询，以及与 payjsapi / PocketBase 联动完成 VIP 开通。

核心流程

1. 前端调用 app/api/pay 发起支付。
2. app/api/pay 按设备分流：
   • 微信内：xorpay
   • PC / 手机浏览器：zpay
3. 支付成功后通过 payjsapi 异步通知写入 PocketBase。
4. 若通知延迟，前端会调用 app/api/pay/confirm 兜底写入 payments + site_vip。

关键配置

复制 .env.example 为 .env.local，按需修改：

变量	说明	默认值
NEXT_PUBLIC_POCKETBASE_URL	PocketBase 地址（浏览器侧）	https://pocketbase.hackrobot.cn
POCKETBASE_URL	PocketBase 地址（服务端）	http://127.0.0.1:8090
PAYMENT_API_URL / NEXT_PUBLIC_API_URL	payjsapi 公网地址	https://api.hackrobot.cn
PAYMENT_API_INTERNAL_URL	同机部署时 payjsapi 内网地址	http://127.0.0.1:8007
PAYMENT_DEFAULT_AMOUNT	默认支付金额（分）	18800
ZPAY_SUBMIT_URL	ZPAY 收银台地址	https://zpayz.cn/submit.php
POCKETBASE_EMAIL / POCKETBASE_PASSWORD	confirm 兜底写库所需管理员账号	-

本地开发

npm install
npm run dev

访问 http://localhost:3000。

自检与已修复问题（2026-04-01）

• 已修复：app/api/pay/confirm 在兜底写 payments 时使用默认金额，可能导致测试价/临时调价场景记账错误。
• 修复后：优先使用支付网关返回的 pay_price（元）换算为分；只有拿不到实际金额时才回退默认金额。

常见排查

• 支付发起失败：优先检查 PAYMENT_API_INTERNAL_URL / PAYMENT_API_URL 是否可达。
• 已支付但未开通：检查 payjsapi 的 /nomadvip/order_status 与异步通知日志。
• 账号已支付但 VIP 未识别：检查 vip_email_link 关联是否建立。