一笔充值为什么对不上服务商收益
开发者购买 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。
审核通过、付款处理中和到账成功应有不同状态。渠道超时时,先查询原支付结果;未确认失败便重复付款,可能造成重复支出。
将容易争议的规则写进上线清单
- 结算口径: 按购买、消费还是其他事件确认;失败、空结果、缓存与重试由谁承担成本。
- 价格变更: 成本价由谁维护,何时生效,历史调用与补录如何选择版本。
- 结算周期: 明确时区、起止区间、出单与确认时间,迟到记录进入哪一期。
- 退款与冲正: 关联原订单和调用;已提现后发生退款时,约定后续抵扣或追偿流程。
- 提现权限: 核对申请人、审核人、收款主体及账户变更流程,保存处理依据。
- 渠道异常: 验证重复通知、付款超时、退回和人工补单,同一笔只确认一次结果。
还应准备三种异常演示:收益已出单但服务商提出异议;提现审核后付款失败;跨账期退款。每种都应能查到原记录、当前责任人和下一步处理动作,而非直接覆盖历史金额。
YesAPI Pro 多商户版需要核对哪些边界
YesAPI Pro 的多商户服务商平台列明服务商入驻、接口上架、成本价设定、收益、结算与提现管理,当前仅 PHP 多商户版明确包含服务商模块。Java 三套餐均含 API 计费;PHP 旗舰版增加计费与支付;PHP 标准版面向接口开放与管理。
这些范围不能推定自动分账、佣金比例、冻结期、退款冲正或支付渠道清算规则已经内置。采购时带上本文的三方记录表与异常清单,预约产品演示,逐项确认现有能力、配置项与开发范围。面向开发者的计费规则则可结合API 接口计费指南一起验收。
参考资料
以下为本文引用的官方资料。文中的通用示例与产品套餐能力分别说明。
接下来,如何选型?
需要服务商结算?从多商户版核对。
服务商入驻、上架、收益、结算与提现列为 PHP 多商户版能力。文章算例不代表产品内置分账规则。
- 准备订单、调用、退款和提现之间的对应记录。
- 明确结算周期、支付执行方与实际到账核对方式。