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

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

对于使用 NewAPI 搭建 AI API 服务、模型聚合平台或企业内部计费系统的用户来说，充值支付属于商业化部署的重要环节。根据 2026 年最新 NewAPI 文档，目前系统仍原生支持 EPay（易支付协议），而支付 FM 提供兼容易支付规范的接口，因此两者可以通过现有 EPay 网关完成对接，不需要重新开发整套支付模块。

一、对接前准备

首先在支付 FM 后台完成可用收款方式配置，然后进入 用户中心 → API 开发信息，获取三个核心参数：

商户号 PID、接入密钥 KEY、易支付兼容接口地址。

这里最容易出错的是接口地址。不要直接复制网上其他商户的示例地址，应以自己后台实际显示的接口地址为准。支付 FM 官方文档也明确说明，不同系统对接口地址末尾 / 或 submit.php 的处理可能不同。

二、NewAPI 配置 EPay

进入 NewAPI 管理后台的：

系统设置 → 支付设置 → EPay

依次填写：

• API 地址：支付 FM 后台提供的易支付兼容地址；
• 商户 ID：对应支付 FM 的 PID；
• 商户密钥：对应 KEY；
• 开启 EPay 支付并保存。

NewAPI 当前官方支付配置就是围绕 API 地址、PID、KEY 三项参数完成，支付通知中带有签名，系统校验成功后可自动完成充值入账。

三、配置支付宝、微信等充值方式 💳

NewAPI 支持在充值方式中设置 alipay、wxpay 等通道标识。用户选择不同付款方式后，系统会将相应类型提交给 EPay 网关。

支付 FM 一侧则需要确保对应支付方式已经配置可用的收款渠道。NewAPI 显示了“微信支付”按钮，并不代表支付 FM 后台一定已经具备对应通道，两边必须保持一致。

四、完整支付链路

正常流程为：

用户提交充值 → NewAPI 创建订单 → 请求支付 FM → 用户完成付款 → 支付 FM 异步通知 NewAPI → NewAPI 验证签名及订单 → 更新订单状态 → 用户余额到账。

其中最关键的是服务器异步通知 notify_url，而不是用户付款后跳回网站的 return_url。

支付 FM 官方接口文档明确指出，页面跳转地址不能作为支付结果的核心验证依据；服务器成功处理支付通知后，需要按照协议返回 success。

五、上线前重点检查 🔍

正式开放充值前，至少完成一次真实小额测试，检查下单、二维码或收银台、支付成功、异步回调以及 NewAPI 余额变化是否形成完整闭环。

如果出现“钱已经支付，但余额没有增加”，优先检查 PID/KEY 是否一致、接口地址是否正确、HTTPS 是否正常、服务器防火墙或 WAF 是否拦截回调，以及支付 FM 后台订单的回调状态。

对于生产环境，还应开启订单日志和支付日志，保留商户订单号与平台交易号，方便发生异常时快速定位。

总体来说，NewAPI 对接支付 FM 的难点并不在代码开发，而在于接口参数、支付方式映射和异步回调链路是否配置正确。只要按照 EPay 规范完成配置，并在上线前把完整支付闭环跑通，就可以实现从用户充值到余额自动到账的一体化支付流程。✅