ADR-0004: 商城不自建支付,全部复用 finance

• 日期:2025(补记) 状态:✅ 生效

背景

商城(hiapi-cloud-shop)是租户内多商家市场,需要支付、分账、退款能力。

决策

• 卖家用 user 账号,不新建账户类型(同 ADR-0001 思路)
• 支付/分账全部复用 hiapi-cloud-finance,shop 不写任何支付渠道代码
• 退款经新建的 Feign 接口调 finance

理由

支付渠道对接(微信/支付宝/回调/对账)是高风险高成本模块,系统内只允许存在一份实现;finance 已具备 Outbox 通知、幂等守卫等基础设施。

影响

• shop 的订单只负责业务态,资金流一律 Feign 委托 finance
• 新业务(store 等)要支付能力时同样遵守本决策