break
98c145fe70
新增收款商户、商户池轮询、微信授权配置独立管理；三类新支付 （C端套餐购买、C端资产钱包充值、代理在线预存款充值）无条件 经商户池选择并冻结路由，无旧综合配置回退。merchant_id 为空 历史支付继续按 payment_config_id 双读。凭证版本化加载与 ID+版本缓存保证轮换一致性。删除商户池新支付创建开关及全部 引用。
2.4 KiB
富友接入契约
元数据
- Owner：支付适配维护人
- 实现：
pkg/fuiou/ - 核验日期：2026-08-07
- 来源：当前代码和商户接口约定；仓库未保存可公开的版本号
当前实际使用范围
系统当前使用微信预下单 POST <ApiURL>/wxPreCreate 与支付通知；代理在线充值恢复流程另有本地 CommonQuery 调用，用于主动查询支付订单状态。交易类型为 JSAPI（公众号）或 LETPAY（小程序）；本地 CommonQuery 代码保持现有请求格式、签名算法、状态映射和恢复语义不变。该源码事实仅表示本地候选实现及后续双读配置来源改造接缝，不证明真实富友渠道契约，也不证明验签、状态解释或恢复核验已通过。
真实核验仍需隔离富友商户、明确接口权限、合法订单样本和允许的网络条件；在这些条件完成前，不得将查单、验签、状态映射或恢复结果作为上线证据。本 Change 不新增富友退款能力。
配置、认证与传输
运行配置包含 API 地址、机构号、商户号、终端号、RSA 私钥、公钥及通知地址。请求先生成 XML，再转换为 GBK，并对请求参数做双重 URL 编码；请求和响应使用 RSA 签名/验签。除 reserved 外的请求字段即使为空也参与 XML 与签名。
关键请求字段包括 mchnt_order_no、order_amt（分）、txn_begin_ts、notify_url、trade_type、sub_openid、sub_appid。响应 result_code=000000 表示渠道成功，并返回富友流水号和 JSAPI 支付字段。
幂等、失败与重试
mchnt_order_no 是渠道业务幂等键；通知处理还需校验签名、商户订单号、金额及当前支付状态。非 000000、验签失败、解码失败或字段不匹配均不得推进支付状态。客户端未实现自动重试，调用方只有在可确认沿用同一商户订单号时才可重试。
安全与验证
RSA 私钥、公钥、机构和商户凭证不得进入文档或普通日志；通知日志必须脱敏。可复现静态证据：pkg/fuiou/client.go、pkg/fuiou/wxprecreate.go、pkg/fuiou/types.go、internal/handler/callback/payment.go。真实验收需使用隔离商户验证两种交易类型、签名失败、金额不符和重复通知；本次不调用真实渠道。
端点、编码、签名字段、成功码或通知语义变化时更新本文。