支付核心流程:
- 支付请求 (RequestBfPay): 计算金额(元→分) → 创建本地订单 → RSA2签名 → 调用慧收钱 NativePay API → 返回二维码链接 (qr_code)
- 支付回调 (BfWebhook): 接收 POST 回调 → RSA2验签 → 解析业务数据 → SUCCESS时调用 RechargeBf 充值 → 返回 SUCCESS 字符串
接口说明
接口编写文件controller/topup_bf.go
- 新增
RequestBfPay支付回调接口 - 新增
BfWebhook处理回调后的内容
修改文件
fai-hub-backend/model/topup.go
可选
- 查询订单 接口
参考APIhttps://docs.baofu.com/docs/interface_document/interface_document-Native-TransNotify
## 支付请求
```mermaid
sequenceDiagram
participant Client as 客户端
participant relayRouter as Relay路由
participant Server as 业务服务
participant BfPay as 慧收钱
Client->>relayRouter: 发起支付请求
relayRouter->>Server: 转发请求
Server->>Server: 金额转换(元→分)
Server->>Server: 创建本地订单
Server->>Server: RSA2签名
Server->>BfPay: 调用 NativePay API
BfPay-->>Server: 返回 qr_code
Server-->>relayRouter: 返回二维码链接
relayRouter-->>Client: 返回二维码
Client->>Client: 展示二维码扫码支付
支付回调
需要配置的选项
- BfEnabled = true
- BfMerchantNo = 商户号
- BfPrivateKey = 商户RSA私钥(PEM)
- BfPublicKey = 平台RSA公钥(PEM,用于验证回调签名)
- BfApiUrl = API地址(默认 https://api.huishouqian.com/api/acquiring,测试环境用 https://test-api.huishouqian.com/api/acquiring)
- BfUnitPrice = 单价(可选,默认1.0)
- BfMinTopUp = 最小充值(可选,默认1)
- BfPayType = 支付类型(可选,默认 DYNAMIC_ALL)
作者:吴升斌 创建时间:2026-04-22 15:33
最后编辑:吴升斌 更新时间:2026-06-22 19:10
最后编辑:吴升斌 更新时间:2026-06-22 19:10