富友支付支持

openspec/specs/agent-funds-commission/spec.md

@@ -122,6 +122,34 @@
 - **WHEN** 充值申请原创建账号不可用，或企业微信线下充值审批场景不可用
 - **THEN** 系统返回相应错误，充值申请保持未关联审批实例，修复条件后可再次发起
 
+### Requirement: 代理在线充值可用支付方式按支付配置判定
+
+系统 SHALL 按当前生效支付配置判定代理在线充值可用支付方式：微信直连（`wechat` 或 `wechat_v2`）配置完整，或富友（`fuiou`）配置完整时，返回 `wechat`；支付宝字段完整时返回 `alipay`。对外支付方式枚举 MUST 固定为 `wechat` 与 `alipay`，MUST NOT 返回 `fuiou`。代理账号以 `wechat` 创建在线充值单时，若生效配置为富友，系统 MUST 使用富友主扫统一下单并将返回的二维码链接作为支付链接。
+
+#### Scenario: 富友配置完整时微信可用
+
+- **GIVEN** 当前生效支付配置 `provider_type=fuiou` 且富友机构号、商户号、终端号、私钥、公钥、API 地址、通知地址均非空
+- **WHEN** 代理账号查询可用支付方式
+- **THEN** 系统返回包含 `wechat` 的方式列表且不包含 `fuiou`
+
+#### Scenario: 微信直连配置完整时微信可用
+
+- **GIVEN** 当前生效支付配置为微信直连且对应字段完整
+- **WHEN** 代理账号查询可用支付方式
+- **THEN** 系统返回包含 `wechat` 的方式列表
+
+#### Scenario: 支付宝字段完整时支付宝可用
+
+- **GIVEN** 当前生效支付配置的支付宝应用 ID、应用私钥、支付宝公钥、通知地址均非空
+- **WHEN** 代理账号查询可用支付方式
+- **THEN** 系统返回包含 `alipay` 的方式列表
+
+#### Scenario: 富友配置下微信创建走主扫下单
+
+- **GIVEN** 当前生效支付配置为富友且字段完整
+- **WHEN** 代理账号以 `wechat` 创建在线充值单
+- **THEN** 系统调用富友主扫统一下单并返回二维码链接作为支付链接，本地充值单支付方式为 `wechat`、支付渠道为 `fuiou`
+
 ## 可达操作索引
 
 本节只用于入口导航，不是行为 Requirement；业务义务以上述 Requirements 为准。