Z Zise Developers
/
Stablecoin Account

稳定币账户

数字资产的持有与流转：余额、充值上报、链上提现与地址簿、交易流水、站内兑换、站内转账。

指南

稳定币账户概述会员的数字资产：余额、充值、链上提现、流水，以及站内兑换与转账。充值上报全系统唯一一个凭空产生会员余额的端点 —— 六道闸一道都不能省。发起提现提现是两段式：提交那一刻钱就从可用余额扣走，之后只有确认或失败两条路。站内兑换两条路：一步成交，或先锁价再成交。成交是原子的，没有中间态。站内转账你的两个会员之间转账：一步到账，没有待审态，且**不能跨商户**。交易流水流水是账本的投影 —— 每一条都对应一次真实的资金变动。这一页给全部字段取值。

Webhook

充值到账一笔充值确认入账、会员余额增加时发送。提现状态提现锁定、完成或失败时发送。兑换成交站内兑换原子成交时发送 —— 这条线没有中间态。转账完成站内转账成交时发送 —— 一步到账，没有待审态。

API 参考 · 25 个端点

余额 Balances

GET /v1/balances 会员逐资产余额（八桶）

交易流水 Transactions

GET /v1/transactions 会员流水（游标分页）

充值 Deposits

GET /v1/deposits 入金记录（我方账本视角） POST /v1/deposits 上报会员入金 动钱 GET /v1/deposits/{id} 单笔入金详情（含链上溯源）

提现 Withdrawals

GET /v1/withdrawals 提现列表（游标分页 + 四个筛选） POST /v1/withdrawals 提现扣账（available → withdrawing） 动钱 GET /v1/withdrawals/{id} 提现详情 POST /v1/withdrawals/{id}/confirm 商户完成链上出款后确认 动钱 POST /v1/withdrawals/{id}/fail 上链失败，全额退回可用 动钱

提现地址簿 Address Book

GET /v1/withdraw-addresses 会员提现地址簿（冷静期未过的标 usable=false） POST /v1/withdraw-addresses 新增提现地址（挂强认证 + 24 小时冷静期） DELETE /v1/withdraw-addresses/{id} 删除提现地址（软删，不挂强认证）

站内兑换 Exchange

GET /v1/exchange/pairs 币对（按方向配：A→B 与 B→A 是两条独立记录） POST /v1/exchange/quotes 兑换报价（默认只读；带 lock 才锁价） GET /v1/exchange/orders 兑换订单列表（游标分页） POST /v1/exchange/orders 兑换成交（原子 · 不可逆 · 无中间态） 动钱 GET /v1/exchange/orders/{id} 兑换单详情（按 id 查一笔）

站内转账 Transfers

GET /v1/transfers/config 站内转账的经营配置（限额 · 费率 · 备注长度） POST /v1/transfers/quotes 转账试算（不动钱 · 不建单 · 不占额度） GET /v1/transfers/recipient-types 收款人标识方式白名单（由服务端下发） POST /v1/transfers/resolve 解析收款人（返回脱敏昵称供二次确认） GET /v1/transfers 转账列表（收发两侧都在内，游标分页） POST /v1/transfers 发起站内转账（一步到账，没有待审态） 动钱 GET /v1/transfers/{id} 站内转账详情（原子、不可逆、无中间态）