交易服务 · 支付模块（pay-Modules）

服务分类：交易服务 —— 对应 store 商城订单与 nflive 下单

模块定位

支付模块：承载商城订单的支付通道与状态闭环， 与统一菜单（商城）、订单管理、统一消息（订单事件）协同完成交易。

功能

• 订单支付：pending → paid（PUT /orders/{id} {status:"paid"}）， 支持支付后状态流转 shipped / completed；
• 超时关单：pending 超过 expires_at（默认 15 分钟）由 Worker 标记 expired 并发布 order.timeout 事件 + 触发告警；
• 支付通道（规划）：微信支付 / 支付宝等通道适配，回调验签后驱动订单状态；
• 对账：支付流水与订单关联，异常汇入告警/工单。

接口要点（订单域，nfarmsd 已实现）

POST /orders                创建订单 {order_id, platform, amount_cents, expires_at?}
GET  /orders?status=        订单列表（admin/service/devops）
PUT  /orders/{order_id}     状态更新 {status: pending|paid|shipped|completed|expired}

数据表：orders；事件：order.created / order.timeout（NATS 主题）。

状态与关联

• 订单域已实现（nfarmsd v2.3.0 + Worker 超时扫描）；第三方支付通道按规划对接；
• 关联前端：store/（支付管理页 payment）、nflive（商城下单/支付演示）；
• 关联模块：menu（商品主数据）、msg（订单事件）、trap（异常告警）。