Aifupay产品系统

主要应用于海外AI工具与数字服务订阅场景。针对国内用户无外币信用卡的痛点，系统提供“人民币支付 ➡️ 自动下发美元虚拟卡”的无人值守服务，一站式打通 ChatGPT 等海外前沿软件的跨境付费壁垒

. 客户端功能（用户侧）
商品浏览与选购：用户可以通过前端页面浏览提供的虚拟服务或工具包。
快捷支付下单：系统提供无缝的结账体验，支持用户输入必要信息后，直接创建订单并跳转至支付网关进行人民币（RMB）支付。
实时订单状态追踪：利用 WebSocket 技术，用户在支付完成后无需手动刷新页面，系统会自动侦听支付状态并在前端实时展示订单流转情况。
自动化交付与展示：支付成功后，系统会自动在页面上向用户交付购买的虚拟卡（Virtual Card）的详细凭证信息。
邮件通知服务：系统会在订单状态更新或交付成功后，自动向用户提供的电子邮箱发送订单确认信息、发票或虚拟卡凭证。
2. 核心业务处理（后端服务侧）
第三方支付集成：通过 与第三方支付网关（如支付宝、微信或聚合支付平台）对接，处理支付请求生成、支付回调（Webhook）验证以及状态同步。
虚拟卡自动化发卡：通过 深度集成第三方虚拟卡提供商的 API。在确认用户付款后，系统在后台自动完成开卡、充值或分配账号的操作，实现真正的“无人值守”自动售货。
动态汇率转换：包含专门的汇率计算模块，用于处理人民币与美元（或虚拟卡计价货币）之间的汇率换算，确保定价和成本核算的准确性。
订单全生命周期管理：提供完整的订单状态机控制。同时配备了后台监控任务，自动清理或取消超时未支付的死单。
3. 后台管理与运维功能（管理侧）
数据面板与订单查询：提供管理人员专属界面，允许管理员查看全站订单记录、交易流水以及每个订单的具体详情。
虚拟卡库存/状态管理：管理员可以追踪售出虚拟卡的激活状态和余额信息。
系统状态配置：支持通过环境变量和配置文件灵活切换支付模式（如测试模式/生产模式）和发卡模式（如模拟发卡/真实 API 发卡）。

1. 技术栈 (Tech Stack)
后端: Node.js, Express (Web框架)
数据库: SQLite (better-sqlite3 嵌入式数据库)
前端: 原生 HTML5 / CSS3 / Vanilla JavaScript (无框架，零构建工具)
通信通信: Fetch API (HTTP 请求), ws (原生 WebSocket)
其他核心库: node-cron (定时任务), dotenv (环境变量), nodemailer/SMTP (邮件服务)
2. 系统架构 (Architecture)
单体 B/S 架构 (Monolithic B/S)：前端静态资源托管与后端 API 接口、后台监控任务全部集成在单一 Node.js 进程中。极大地降低了部署门槛。
事件驱动的实时推送模型：摒弃了传统的客户端轮询（Polling），采用 WebSocket 长连接架构。支付网关的回调（Webhook）触发后端状态变更后，服务器主动向客户端推送事件，实现页面的无缝流转。
策略模式/适配器架构 (Strategy/Adapter Pattern)：对外部第三方服务（特别是虚拟卡供应商）进行了高度抽象，系统不强绑定单一供应商。
3. 实现亮点 (Implementation Highlights)
高度抽象的多服务商发卡引擎：核心代码（virtualCard.js）实现了卓越的适配器模式。系统同时集成了 Stripe, Airwallex, Lithic, Nobepay, Dupay 等超过 7 家全球头部虚拟卡 API。运营者只需在配置文件中修改密钥，即可无缝切换底层发卡通道，代码具备极高的扩展性和容灾能力。
极致轻量化与开箱即用：放弃了 React/Vue 等重型前端框架以及 MySQL/Redis 等外部数据库。整个系统依靠 SQLite 单文件数据库运行，“Clone 即用”，非常契合独立开发者或小团队的快速部署和低成本运维需求。
全自动化闭环与优雅回退：实现了从“支付 -> 开卡 -> 发货 -> 邮件通知”的 100% 无人值守闭环。同时内置了 Mock（模拟）发卡环境，方便在本地无损调试整个支付和状态机逻辑。
4. 业务与技术难点 (Challenges)
跨平台分布式事务与状态一致性：系统夹在“国内人民币支付网关”和“海外美元虚拟卡 API”之间。处理支付网关的异步回调（Webhook）、应对海外 API 偶尔的超时或报错，并确保给用户只发一次卡（幂等性）且不丢单，是状态机逻辑中的最大难点。
实时汇率与动态定价策略：需要处理 RMB 与 USD 之间的动态汇率转换。既要保证提供给用户的价格实时性，又要兼顾汇率查询 API 的限流约束，同时还要确保运营利润率，避免汇率波动导致的倒挂亏损。
第三方风控限制与错误处理：像 Stripe 或 Airwallex 等发卡渠道具有极严的风控（KYC、账单地址验证、单笔限额）。系统需要动态组装合规的账单地址、限制卡片的交易类别（MCC），并在发卡 API 拒绝请求时向前端抛出友好的提示并执行资金退款或阻断。