很多人第一次写合约返佣计算明细，容易只给一个“应返总额”，结果财务、代理和用户三方对不上。其实，合约返佣计算明细怎么写的关键，是让每一笔返佣都能从手续费追溯到比例，再从比例复算到结算金额。明细不是越复杂越好，而是字段完整、口径统一、可核对。

一、先定口径：给谁看、算什么

动笔前先确认三件事：返佣对象是谁、结算周期多长、以什么币种结算。是用户返佣、代理返佣还是渠道返佣，决定了明细要不要展示上级关系；日结、周结还是月结，决定了统计区间；USDT、BTC 还是其他币种结算，决定了是否需要标注汇率口径。

  • 返佣对象：用户、代理或渠道，名称和UID要写清。
  • 结算周期：起止时间精确到日或小时，避免跨期重复。
  • 返佣基数：通常按实际扣收的手续费计算，不按成交额直接乘比例。
  • 比例来源：固定比例、阶梯比例还是活动比例，要注明适用规则和生效时间。

二、核心公式与字段

单笔应返 = 该笔实际手续费 × 该笔适用返佣比例；周期应返 = 周期内单笔应返合计 − 调整项；待返 = 周期应返 − 已返。调整项包括补返、扣回、负手续费抵扣等，必须单列，不能直接混进比例里。

示例

某笔 BTCUSDT 永续合约成交额 50,000 USDT，taker 手续费率 0.05%，实际手续费 25 USDT，返佣比例 40%，则单笔应返 = 25 × 40% = 10 USDT。若本期已返 6 USDT，另有 2 USDT 历史调整，待返 = 10 − 6 − 2 = 2 USDT。明细中要同时保留手续费 25、比例 40%、应返 10、已返 6、调整 2、待返 2，方便逐项核对。

三、明细表建议包含哪些字段

  • 订单信息：交易时间、订单号、交易对、方向、开平、成交均价、成交数量、成交额。
  • 手续费信息：手续费币种、手续费金额、maker/taker