Account Center
账户中心
支撑其余全部产品的平台层:令牌与签名、商户账户与预付、会员建档、KYC、Webhook、沙盒、对账单与报表。
指南
账户中心概述账户中心是其余五个产品的地基:令牌、商户账户、会员、Webhook 都在这儿。快速开始从拿到 API Key 到跑通第一个真实调用,五分钟。鉴权与签名一把 Key 两个值:一个换令牌,一个验签。PATH 必须进签名串。API Key 与轮换一把 Key 两个值、轮换有重叠窗口、IP 白名单可选 —— 三件事各有一个容易踩的坑。强认证会员的高危动作要一张强认证票据 —— 谁来出,怎么用。幂等什么时候沿用同一把幂等键,什么时候必须换新 —— 两者的方向相反。分页游标分页:拿到 next_cursor 就还有下一页,拿不到就是到底了。限流限流按商户与端点分桶,429 带 Retry-After。错误契约按 code 分支,不要按 HTTP 状态码分支 —— 几个反直觉的都是 400。版本与兼容性我方承诺什么不会变、什么会加,以及新增枚举怎么提前告诉你。代会员调用代会员调用:什么时候必须带 x-on-behalf-of,带错会怎样。会员建档与生命周期会员是你的用户。我方给他一个身份与一套账本,其余的(定价、限额、风控)都是你的事。创建会员与 KYC 全流程一张图看完:从建会员到实名通过,谁在什么时候做什么,以及三处最容易走错的岔口。KYC 概览与等级等级决定会员能做哪些业务。结论由我方给,资料由会员在我方托管的屏上填。L1 实名:托管屏与资料清单换一条链接给终端用户,他在我方的屏上填十五个字段、传证件照片 —— 数据不经过你。L2 进阶认证与 L1 同型的一张托管屏。19 个字段、两份必传证明 —— 而那几百项选项表由我方页面渲染,你拿不到也不需要。补件「待补件」不是失败,是差几样东西。补件表单也是我方托管的。Webhook事件只带 ID 与状态,详情回查。验签、去重、重投三件事。Webhook 配置与排障配端点、验签、重投、排障 —— 收不到事件时按这一页的顺序查。商户账户与预付预付账户、授信、低水位 —— 三个数决定你的业务什么时候会停。对账单与托管核对对账单按日出,托管核对回答「我方替你记着的钱对不对」。沙盒沙盒是一个影子商户主体:自己的余额、自己的会员、自己的订单。Go-live 检查清单上线前逐条对一遍:凭证、Webhook、限额、对账、告警。
Webhook
API 参考 · 38 个端点
令牌 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 + 最小字段,无影像、无档案)
POST
/v1/kyc/profile-sessions
实名档案更新 —— 换一张托管屏链接
GET
/v1/kyc/requirements
各业务线要求的 KYC 层级
POST
/v1/kyc/sessions
发起一次 L1 实名(我方托管屏,返回一条链接)
POST
/v1/kyc/l2/sessions
换一条 L2 进阶认证的托管屏链接
GET
/v1/kyc/supplements
待补件请求与我方托管的填写链接
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
建一个对账报表导出任务(异步 · 出 CSV)
GET
/v1/reports/{id}
单个导出任务的状态(这是轮询口)
GET
/v1/reports/{id}/content
取导出件(响应体是 CSV,不是 JSON)