商业化与交付

API 多商户服务商如何结算?订单、收益与提现对账清单

用一组明确假设的订单、调用和提现数据,核对开发者消费、服务商应结算金额与银行到账,整理退款、结算周期和支付渠道的验收边界。

一笔充值为什么对不上服务商收益

开发者购买 1,000 元的调用额度,本月只使用其中一部分,服务商随后申请提现 250 元。这三个金额不同,首先应查清它们各自对应的业务事件:开发者付款形成订单,实际调用形成消费与服务商收益记录,提现完成形成资金支付记录。

API 多商户服务商结算需要将这条链路串起来。充值金额、接口销售金额、应结算金额和实际到账金额,应分别核对。若只拿支付订单减提现总额,无法解释尚未消费的额度、跨期结算和退款。

以下是通用运营设计示例,用于整理需求和验收,不代表 YesAPI Pro 已内置同样的结算规则,也不构成会计或税务处理结论。

先确定三类主体与四组关联记录

开发者是购买和调用 API 的客户;平台负责商品、接入与运营;服务商提供接口能力。支付渠道、银行承担各自约定的资金处理职责。合同中还要说明谁与开发者签约、谁收款、谁处理退款及开票需求。

记录 建议保留的关联字段 回答的问题
订单与支付 客户、订单号、渠道交易号、金额、币种、支付时间 谁支付了多少钱,是否只入账一次
调用与消费 请求号、接口、服务商、计费事件号、销售规则版本 哪次业务形成了多少消费
服务商收益 计费事件号、成本价版本、账期、调整记录、结算单号 该付给谁,按什么依据计算
提现与支付 提现单号、结算单号、审核人、渠道流水、到账结果 申请、批准、付款和到账是否一致

这些是建议核对字段,具体存储和导出能力要在产品演示中验证。平台内部标识与渠道流水分开保存;修改成本价时保留生效范围,历史收益才能按原规则复算。

用一张示例账核对消费与应结算金额

假设某接口销售价为每次 5 分、服务商成本价为每次 3 分;只有符合双方约定的有效调用才结算。某账期原记 10,000 次,复核后有 400 次需要冲正。本例假设合同允许销售金额与服务商金额同步冲正;实际退款承担方式须另行确认。

项目 计算 金额
开发者购买额度 已支付订单 100,000 分,即 1,000 元
原记销售金额 10,000 × 5 分 50,000 分,即 500 元
销售冲正 400 × 5 分 −2,000 分,即 −20 元
本期净消费 9,600 × 5 分 48,000 分,即 480 元
服务商原记金额 10,000 × 3 分 30,000 分,即 300 元
服务商冲正 400 × 3 分 −1,200 分,即 −12 元
本期应结算金额 9,600 × 3 分 28,800 分,即 288 元

在没有其他消费、赠送和调整的假设下,开发者剩余额度为 100,000 − 48,000 = 52,000 分,即 520 元。这里的 20 元冲正退回平台额度,没有发生银行卡退款;若退回原支付渠道,应再关联独立退款单与渠道结果。

销售与服务商金额相差 19,200 分,即 192 元,这只是本例两项金额之差,还没有扣除支付、基础设施和运维费用,不能据此声称平台利润。运营费用可继续参考平台成本对账示例。

提现申请通过后,还要核对实际支付

沿用上例,假设服务商期初可结算余额 5,000 分,本期 28,800 分已经满足约定的结算条件,没有冻结或其他调整;服务商申请并成功收到 25,000 分,即 250 元,则剩余可结算余额为:

5,000 + 28,800 - 25,000 = 8,800 分,即 88 元

假设另有 200 分渠道费用由平台承担,服务商仍应到账 25,000 分,平台相关资金支出合计为 25,200 分。若费用改由服务商承担,应重写规则和到账预期,不能在付款时临时扣减。

Stripe 余额汇总文档也区分余额变动与提现关联对账:按期间汇总的交易不一定就是某一笔提现所包含的交易。这里借用的是核对思路,不表示 YesAPI Pro 使用或集成了 Stripe。

审核通过、付款处理中和到账成功应有不同状态。渠道超时时,先查询原支付结果;未确认失败便重复付款,可能造成重复支出。

将容易争议的规则写进上线清单

  1. 结算口径: 按购买、消费还是其他事件确认;失败、空结果、缓存与重试由谁承担成本。
  2. 价格变更: 成本价由谁维护,何时生效,历史调用与补录如何选择版本。
  3. 结算周期: 明确时区、起止区间、出单与确认时间,迟到记录进入哪一期。
  4. 退款与冲正: 关联原订单和调用;已提现后发生退款时,约定后续抵扣或追偿流程。
  5. 提现权限: 核对申请人、审核人、收款主体及账户变更流程,保存处理依据。
  6. 渠道异常: 验证重复通知、付款超时、退回和人工补单,同一笔只确认一次结果。

还应准备三种异常演示:收益已出单但服务商提出异议;提现审核后付款失败;跨账期退款。每种都应能查到原记录、当前责任人和下一步处理动作,而非直接覆盖历史金额。

YesAPI Pro 多商户版需要核对哪些边界

YesAPI Pro 的多商户服务商平台列明服务商入驻、接口上架、成本价设定、收益、结算与提现管理,当前仅 PHP 多商户版明确包含服务商模块。Java 三套餐均含 API 计费;PHP 旗舰版增加计费与支付;PHP 标准版面向接口开放与管理。

这些范围不能推定自动分账、佣金比例、冻结期、退款冲正或支付渠道清算规则已经内置。采购时带上本文的三方记录表与异常清单,预约产品演示,逐项确认现有能力、配置项与开发范围。面向开发者的计费规则则可结合API 接口计费指南一起验收。

参考资料

以下为本文引用的官方资料。文中的通用示例与产品套餐能力分别说明。

接下来,如何选型?

需要服务商结算?从多商户版核对。

服务商入驻、上架、收益、结算与提现列为 PHP 多商户版能力。文章算例不代表产品内置分账规则。

  • 准备订单、调用、退款和提现之间的对应记录。
  • 明确结算周期、支付执行方与实际到账核对方式。

需要把这些问题落到项目上?

整理目标接口、技术栈与部署边界,预约一次有重点的产品演示。

预约产品演示
↑