Account Center
账户中心
支撑其余全部产品的平台层：令牌与签名、商户账户与预付、会员建档、KYC、Webhook、沙盒、对账单与报表。
指南
账户中心概述账户中心是其余五个产品的地基：令牌、商户账户、会员、Webhook 都在这儿。快速开始从拿到 API Key 到跑通第一个真实调用，五分钟。鉴权与签名一把 Key 两个值：一个换令牌，一个验签。PATH 必须进签名串。API Key 与轮换一把 Key 两个值、轮换有重叠窗口、生产环境必配 IP 白名单 —— 三件事各有一个容易踩的坑。强认证会员的高危动作要一张强认证票据 —— 谁来出，怎么用。幂等什么时候沿用同一把幂等键，什么时候必须换新 —— 两者的方向相反。分页游标分页：拿到 next_cursor 就还有下一页，拿不到就是到底了。限流限流按商户与端点分桶，429 带 Retry-After。错误契约按 code 分支，不要按 HTTP 状态码分支 —— 几个反直觉的都是 400。时间与时区原时间字段保持兼容，新增 UTC Unix 毫秒时间戳；显示时区由客户端决定。版本与兼容性我方承诺什么不会变、什么会加，以及新增枚举怎么提前告诉你。代会员调用代会员调用：什么时候必须带 x-on-behalf-of，带错会怎样。会员建档与生命周期会员是你的用户。我方给他一个身份与一套账本，其余的（定价、限额、风控）都是你的事。创建会员与 KYC 全流程一张图看完：从建会员到实名通过，谁在什么时候做什么，以及三处最容易走错的岔口。KYC 概览与等级等级决定会员能做哪些业务。结论由我方给，资料可由商户服务端提交和更新，也可使用托管页面。L1 实名：托管屏与资料清单换一条链接给终端用户，他在我方的屏上填十五个字段、传证件照片 —— 数据不经过你。下游商户 L2 进阶认证 OpenAPI 接入说明商户上传文件并直接提交 L2 参数，查询审核与补件，全流程无需托管页面。快捷 KYC平台资料池独占绑定到某个会员，只用来向开卡行建用卡人。不是实名，也不能做速汇。KYC 补件查询待补件模板，上传证明并提交 JSON；L1、L2 均可通过 API 完成。Webhook事件只带 ID 与状态，详情回查。验签、去重、重投三件事。Webhook 配置与排障配端点、验签、重投、排障 —— 收不到事件时按这一页的顺序查。商户账户与预付预付账户、授信、低水位 —— 三个数决定你的业务什么时候会停。对账单与托管核对对账单按日出，托管核对回答「我方替你记着的钱对不对」。沙盒zinfra.dev 是独立测试环境，拥有自己的余额、会员与订单。Go-live 检查清单上线前逐条对一遍：凭证、Webhook、限额、对账、告警。
Webhook
API 参考 · 47 个端点
令牌 Token
商户账户 Merchant
GET
/v1/merchant
商户资料、被授权产品、生效限额
GET
/v1/merchant/balances
商户资金账户（可用 / 冻结 / 待结算 / 托管声明）
GET
/v1/merchant/lines
本商户开通了哪几条业务线（含低水位自动停售状态）
GET
/v1/merchant/pending
因预付不足而排队的订单（笔数 / 逐资产 / 最早一笔）
GET
/v1/merchant/statements
业务扣款记录（每单最终从预付扣了多少）
GET
/v1/merchant/custody
托管核对（balanced=false = 有余额没有你的声明背书）
GET
/v1/merchant/deposit-addresses
预付充值地址清单
POST
/v1/merchant/deposit-addresses
申请预付充值地址（按 币×网络 复用）
GET
/v1/merchant/payout-addresses
你的提现地址簿（只读，没有 POST）
GET
/v1/merchant/payouts
你提过的提现单（只读，没有发起口）
GET
/v1/merchant/topups
预付充值单（链上到账 + 线下结算两条腿）
POST
/v1/merchant/topups
申报一笔预付充值（主要用于线下结算）
会员 Members
GET
/v1/members
会员列表（游标分页）
POST
/v1/members
建会员
GET
/v1/members/{id}
会员详情（KYC 层级、处置态）
PATCH
/v1/members/{id}
改商户侧属性（昵称、语言）
POST
/v1/members/{id}/suspend
商户级停用（不影响该人在其他商户）
POST
/v1/members/{id}/email-sessions
换绑账号邮箱 —— 换一张托管屏链接
POST
/v1/members/{id}/sessions/revoke
强制会员下线（不是封禁，可立刻重登）
GET
/v1/members/{id}/limits
该会员的额度占用（只读，不下发上限）
实名 KYC
GET
/v1/kyc
KYC 结论（level + 最小字段，无影像、无档案）
PATCH
/v1/kyc
直接更新会员 KYC 资料（部分更新）
GET
/v1/kyc/quick
该会员已绑的快捷 KYC（无证件号、无影像）
POST
/v1/kyc/quick
为会员独占绑定一份快捷 KYC
POST
/v1/kyc/files
上传会员 KYC 文件到 Zinfra 私有存储
POST
/v1/kyc/applications
提交会员 L1 KYC（服务端直交）
POST
/v1/kyc/profile-sessions
实名档案更新 —— 换一张托管屏链接
GET
/v1/kyc/requirements
各业务线要求的 KYC 层级
POST
/v1/kyc/sessions
发起一次 L1 实名（我方托管屏，返回一条链接）
GET
/v1/kyc/l2/config
查询 L2 参数选项及会员申请条件
GET
/v1/kyc/l2/applications
查询最近一份 L2 申请及补件状态
POST
/v1/kyc/l2/applications
商户通过 JSON 提交 L2 进阶认证
POST
/v1/kyc/l2/sessions
换一条 L2 进阶认证的托管屏链接
GET
/v1/kyc/supplements
查询待补件请求和参数模板
POST
/v1/kyc/supplements/{id}
通过参数提交 L1 或 L2 补件
Webhook Webhooks
GET
/v1/webhooks/deliveries
Webhook 投递记录（不含 payload）
POST
/v1/webhooks/deliveries/{id}/redeliver
重投（只有 dead / failed / no_subscriber 可重投）
资产目录 Assets
报表导出 Reports
GET
/v1/reports
我的导出任务列表
POST
/v1/reports
建一个对账报表导出任务（异步 · 出 xlsx）
GET
/v1/reports/{id}
单个导出任务的状态（这是轮询口）
GET
/v1/reports/{id}/content
取导出件（响应体是 xlsx，不是 JSON）