伙伴入库
回执
Excel 和通用 API 的入库记在这里。失败而且可以重试的，沿用原来的外部编号再送一次。同一编号不会重复入账。不托管资金。
通用 API 的路径、配置状态和结果码在下面的联调台。Excel 文件在联调台下面上传。推过来的行，来源标成通用 API。令牌不出现在这一页。
回执写在库里·已封日快照的净额和分成不改·表格映射
Ingest
联调台
partnerIngestConfigured·已配置
核对非 DH 入库。下面是相对本站的两条路径。令牌留在服务器，不出现在页面上，复制内容里也没有。
令牌已写在服务器上。这一页看不到它，也不能复制。
通用入库
POST /api/partners/v1/ingest
原机器通道
POST /api/ingest/v1/receipts
- Bearer
- 请求头 Authorization 写 Bearer，值是服务器上的伙伴令牌，不是登录口令。这一页不展示令牌，复制出来的也只是路径。
- Idempotency-Key
- 同一笔用这把请求头。它优先于正文里的 idempotencyKey。没有显式键时，仍按订单号、业务日、金额、类型和币种去重。
- accepted
- 第一次成功写入。HTTP 200，status 为 accepted。
- duplicate
- 同一把键再送。HTTP 200，status 为 duplicate，不重复入账。
- unauthorized
- 令牌未配置、请求没带 Bearer，或令牌不对。HTTP 401，code 为 unauthorized。
Import
Excel 导入
下载模板非 DH 伙伴按模板填表上传。每一行走通用入库的同一套校验和写入。某一行认不出时，只跳过这一行，其余行仍然入账。不另开导入批次，不发邮件，不删已入账的行。
.xlsx 或 .csv·不超过 2MB·一次最多 500 行·部分成功不会整表回滚
订单号orderNo必填
与通用 API 的 orderNo 相同
金额amount必填
正数。收款和退款都写正数
业务日期businessDate必填
YYYY-MM-DD
币种currency可空
只认 CNY，空着按 CNY
类型kind必填
receipt / refund，或收款 / 退款
冲销reverses可空
退款指向的订单号。多笔写成订单号@业务日
对方counterparty可空
不参与封账
备注note可空
不参与封账
幂等键idempotencyKey可空
空着按订单号、业务日、金额、类型、币种去重
分成sharePercent可空
空着用页面上的分成，再没有则默认 10
| 回执 | 来源 | 状态 | 时间 | 错误摘要 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
cmvokzbgk0008jmjy6zkrrsy1通用 API已接受2026-10-26 09:31—已入库·来源标记：通用 API·外部编号 pr40-deploy-probe-20261026·第 1 次·头寸 0.10 入账行
| ||||||||||||||
已连接数据库·不托管 · 不代付·在接口里看