企业支付系统需要哪些 API？

先按业务动作拆分 API

企业支付系统至少要处理交易创建、状态查询、退款和异步通知。平台型业务还会增加分账、代付和对账接口。每个接口都应明确请求方、幂等键、状态变化和失败后的处理方式。

常见 API 的职责

1. 支付接口：提交金额、订单、主体和回调信息。
2. 查询接口：在通知缺失或状态不明确时确认结果。
3. 退款接口：关联原交易并记录退款原因和金额。
4. 通知接口：将状态变化推送回业务系统。
5. 分账、代付和对账接口：处理结算动作、付款批次和账务核对。

接口设计中需要提前约定的内容

• 平台订单号和渠道订单号的关联方式。
• 支付、退款和付款状态的枚举及转换。
• 请求重复提交和异步通知重复到达的处理。
• 金额精度、签名、权限、日志和敏感字段范围。

API 接入验收重点

测试不应只验证支付成功，还要覆盖超时、重复通知、退款失败、金额不一致、回调重放和对账差异。每种异常都需要能定位到订单、主体和原始请求。

商福通相关能力

商福通开发者中心提供企业评估支付、分账、代付和数据对接路径的入口。具体接口名称、字段和调用限制需要以正式开发文档及合作渠道要求为准。

上线前验证清单

接口验收应覆盖成功、超时、签名错误、重复请求、通知重放和查询补偿。测试记录要保留请求编号、业务订单号、状态变化和响应时间，方便技术与业务共同确认接口行为。

常见问题

只有支付接口能不能先上线？

可以分阶段上线，但查询、通知和对账能力应同步设计，否则异常交易难以确认。

查询接口和通知接口有什么区别？

通知适合接收状态变化，查询适合在通知缺失、延迟或需要主动核验时确认结果。

为什么要给每个请求设计幂等键？

网络重试和用户重复操作都可能造成重复请求，幂等键可以帮助系统识别同一业务动作。

本文用于解释企业支付及资金管理相关概念。具体业务以实际产品能力、合作渠道及正式服务协议为准。