NewAPI 接入支付 FM 接口实现支付全流程教程

一、前言

相信很多用 NewAPI 的朋友都有个困扰——它作为一款超实用的开源大模型接口网关，聚合和分发模型的能力没话说，但默认是没有支付功能的。想靠 API 变现、收点服务费，没支付通道可不行。

刚好支付 FM 是国内比较主流的聚合支付平台，而且完美兼容易支付规范，不用复杂开发，甚至零代码就能给 NewAPI 搭好完整的支付链路，支付宝、微信收款都能实现。今天就手把手跟大家分享，我自己实操过的接入全过程，步骤都拆细了，跟着来就能成。

二、前置准备

2.1 支付 FM 账户配置

首先得搞定支付 FM 这边的基础配置，很简单，跟着步骤来就行：

第一步，注册并认证。先去支付 FM 官网注册个账户，然后完成实名认证，个人和企业都可以，认证完才能解锁所有支付通道，不然没法正常收款。

第二步，获取核心接入参数（重点！后面配置要用）。登录支付 FM 后台后，找到「用户中心→API 开发信息」，这里要记三个关键信息：

• 商户号（PID）：平台给你分配的唯一标识，相当于你的支付“身份证”

• 接入密钥（KEY）：用来做签名验证的，相当于支付的“密码”，一定要妥善保存，不能泄露

• 接口根地址：就是这个 https://api-xxx.zhifu.fm.it88168.com/api （这是你专属的 API 域名，不用改，直接复制用）

另外记得确认一下，易支付的跳转接口和 JSON 接口都能正常用，避免后面踩坑。

第三步，配置支付方式。在支付 FM 后台，把你的支付宝、微信收款账号添加上，完成通道绑定，确保这些收款渠道是正常可用的状态，不然用户付不了钱。

2.2 NewAPI 部署准备

NewAPI 这边也要提前准备好，满足这三个条件就可以：

• 已经完成 NewAPI 部署（不管是 Docker 部署还是源码部署都行），能正常登录后台管理界面

• 服务器要开放 80/443 端口，这个很关键，不然支付 FM 的回调请求进不来，支付成功后没法同步到 NewAPI

• NewAPI 版本要在 v0.0.1 及以上，这个版本及以后的都支持易支付（EPay）网关，老版本的话建议先升级

三、NewAPI 后台支付网关配置

这一步是核心，也是最容易操作的一步，全程在 NewAPI 后台完成，不用写一行代码。

3.1 进入支付设置页面

登录 NewAPI 后台，按照「系统管理→集成→支付网关」的路径点进去，找到「Epay 网关」的配置区域，就是我们要操作的地方。

3.2 填写支付 FM 核心参数

这里直接对照表格填就行，每一项都给大家说清楚，别填错了：

配置项	填写内容	说明
Epay 端点	https://api-xxx.zhifu.fm.it88168.com/api	就是支付 FM 给你的接口根地址，直接复制粘贴，别多删一个字符
易支付商户 ID	支付 FM 后台的商户号（PID）	比如：643950146480390144，按你自己后台的实际号码填
Epay 密钥	支付 FM 后台的接入密钥（KEY）	一定要和支付 FM 后台的密钥完全一致，区分大小写，错一个字母都不行
回调地址	https://你的NewAPI域名	系统会自动生成，重点确认你的 NewAPI 域名能公网访问，不然回调失败

3.3 保存配置

填完所有参数后，点击「保存 Epay 设置」按钮，系统会自动验证这些参数对不对。如果提示配置成功，那就说明基础配置搞定了；要是提示失败，大概率是商户号、密钥填错了，回去核对一下再重新保存。

四、支付流程测试

配置完别着急上线，先测试一遍，确保整个支付流程能正常走通，避免用户付款后出问题。

4.1 发起充值订单

先登录 NewAPI 的用户前台，找到「充值中心」，随便选一个充值金额（比如 7.3 元，测试用不用多充），然后点击充值按钮。

正常情况下，系统会自动跳转到支付 FM 的收银台页面，并且生成支付宝或者微信的支付二维码，到这一步就说明前面的配置没问题。

4.2 完成支付与回调验证

用支付宝或者微信扫码，完成支付（测试的话可以用自己的账号付，付完再申请退款就行）。支付成功后，支付 FM 会自动向我们刚才配置的回调地址发送通知。

正常情况下，NewAPI 后台会自动校验签名，然后更新用户的余额，前台也会实时显示充值成功。

如果发现订单状态一直没更新，别慌，按这三点排查：

• 服务器防火墙是不是把支付 FM 的回调 IP 挡住了，放行一下就行

• NewAPI 的回调地址有没有配置错，对照前面的表格再检查一遍

• 商户号和密钥是不是填错了，这是最常见的问题，再核对一次

五、常见问题与排查

整理了几个我自己接入时踩过的坑，还有大家可能遇到的问题，对应排查方法都给大家列出来，省得大家走弯路。

5.1 支付后余额未增加

这种情况大多和回调有关，按这三步查：

• 检查服务器是不是开启了 SSL 证书，回调地址必须是 HTTPS 协议，HTTP 会导致回调失败

• 查看 NewAPI 的日志，确认一下有没有收到支付 FM 的回调请求，没收到就是地址或端口的问题

• 去支付 FM 后台的「订单管理」看看，订单状态是不是“已支付”，如果是“未支付”，就是用户没付成功

5.2 收银台页面无法打开

主要是接口地址或网络的问题，排查这两点：

• 检查支付 FM 的接口地址是不是填错了，复制的时候别多删或者多添字符，确认域名能正常解析

• 排查一下服务器网络，确保 NewAPI 能正常访问支付 FM 的 API 域名，有时候服务器限速也会导致打不开

5.3 签名验证失败

这个问题基本都是参数填错导致的，重点查两点：

• 商户号和密钥必须和支付 FM 后台完全一致，尤其是密钥，区分大小写，别少输一个符号

• 确认 NewAPI 系统的时间和支付 FM 服务器的时间，误差不能超过 5 分钟，时间差太大也会导致签名失败

六、进阶配置建议

如果大家想让支付功能更贴合自己的业务，这里有几个小建议，按需配置就行：

• 支付方式限制：在支付 FM 后台配置支付方式关联，比如只让用户用支付宝支付，或者只开微信通道，根据自己的需求来

• 充值金额设置：在 NewAPI 后台配置预设充值金额，还能设置阶梯折扣，比如充100送10，充200送25，吸引用户多充

• 轮循池优化：如果收款账号比较多，可以用支付 FM 的轮循池功能，实现负载均衡，避免单个账号收款过多出问题

• 安全加固：定期更换支付 FM 的接入密钥，另外限制一下 NewAPI 后台的 IP 访问权限，避免后台被非法访问，保障支付安全

七、结语

其实整个接入过程真的很简单，借助支付 FM 的易支付兼容接口，不用写一行代码，只要按步骤配置好参数，就能给 NewAPI 搭好完整的支付链路，支付宝、微信收款都能实现自动到账、自动回调。

这个方案特别适合个人开发者和小型团队，想快速实现 AI 网关的商业化变现，用这个方法准没错。后续如果想对接其他支付平台，也可以参考这个流程，因为都是基于易支付规范，配置逻辑差不多。

最后提醒一句，接入完成后一定要多测试几次，确保支付、回调、余额更新都正常，再正式上线给用户使用，避免出现收款不到账的问题~