开发者文档

接入 API 账单对账工具

把 New API、One API、one-hub 或文件导出的账单数据规范化,再核对下游消费、上游成本与支付入账。

安全边界

PayAPIKey 托管接口不接收中转站管理员 Token、渠道 Key、Cookie 或会话。原生 API 读取必须在你控制的本地 connector/sidecar 中完成;托管端只接收去敏后的计费元数据。

工作方式

1

本地读取

由你控制的 connector 或 sidecar 使用管理员凭据读取中转站原生 API。

2

去敏与规范化

在本地移除 Key、Cookie、会话、提示词和响应正文,只提交计费元数据。

3

无状态对账

托管接口即时返回规范化结果或差异报告,不提供管理员凭据保管。

三本账必须分开

充值不是消费收入。对账引擎分别处理下面三类事实,避免把现金到账直接当作已经履约的收入。

01

下游消费账

用户请求、模型、渠道、已扣金额、退款和价格快照;消费发生时确认收入。

02

上游成本账

上游请求 ID、实际成本与退款;按 requestId 匹配下游消费并计算毛利。

03

支付与钱包账

支付捕获、手续费、退款、拒付与钱包入账;用于核对资金,不并入消费收入。

两条命令开始

先取得完整示例,再把响应中的 data 对象提交给对账接口。示例不包含真实凭据或业务数据。

Shell
curl -s https://www.payapikey.com/api/v1/examples/reconciliation \
  | jq '.data' > reconciliation.json

curl -s -X POST https://www.payapikey.com/api/v1/reconcile \
  -H 'Content-Type: application/json' \
  --data-binary @reconciliation.json | jq

单次 JSON 请求上限为 2 MB,每本账最多 5,000 条记录。生产环境请按结算周期分批。

选择对接方式