支付核心流程:

  1. 支付请求 (RequestBfPay): 计算金额(元→分) → 创建本地订单 → RSA2签名 → 调用慧收钱 NativePay API → 返回二维码链接 (qr_code)
  2. 支付回调 (BfWebhook): 接收 POST 回调 → RSA2验签 → 解析业务数据 → SUCCESS时调用 RechargeBf 充值 → 返回 SUCCESS 字符串

接口说明

接口编写文件controller/topup_bf.go

  • 新增RequestBfPay 支付回调接口
  • 新增BfWebhook 处理回调后的内容

修改文件

fai-hub-backend/model/topup.go


可选
- 查询订单 接口

参考API

https://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: 展示二维码扫码支付

支付回调

慧收钱Relay路由业务服务POST 支付回调转发回调请求RSA2验签返回失败解析业务数据返回 SUCCESS(忽略)调用 RechargeBf 充值更新订单状态返回 SUCCESSalt[状态 != SUCCESS][状态 = SUCCESS]alt[验签失败][验签成功]返回 SUCCESS慧收钱Relay路由业务服务

需要配置的选项

作者:吴升斌  创建时间:2026-04-22 15:33
最后编辑:吴升斌  更新时间:2026-06-22 19:10