Z Zise Developers English
账户中心 › 指南

预付账户、授信、低水位 —— 三个数决定你的业务什么时候会停。

商户账户与预付

所有成本都从预付里扣

我方不帮商户垫一分钱。你的每一笔业务在成交之前,我方要向你收的那部分会先从预付账户里冻结,成交时结算。


预付余额  ──冻结──►  冻结中  ──结算──►  我方收入
   ▲                    │
   └────── 释放 ────────┘   (订单取消/失败)

预付是逐资产的:USDT 的成本从 USDT 的预付里扣,不会跨资产折算。

授信

授信是我方给你的敞口,它算进可用额:


有效可用 = 预付余额 + 授信额度

所以调低授信会立刻把你推向停售 —— 这也是为什么它在我方这边是双人审批。

低水位三档

按「按日均消耗还够烧几天」算,不按绝对金额(不同规模的商户,一个绝对值不可能对所有人都合适):

档发生什么
预警给你配的收件人发邮件
告警再发一次,更急
停售相关业务线停止受理新单

⚠ 停售时会员看到的是「暂时不可用」,不会说「你的平台没钱了」。

我方与你之间的资金状况不透给终端用户。

八条业务线,各自有开关


GET /v1/merchant/lines
线是什么
deposit充值上报
withdraw提现扣账
remit汇款
qrpay扫码付
card发卡
earn理财
exchange站内兑换
transfer站内转账

每条线三个位:

字段含义谁能改
enabled这条线开没开通只能找客户经理
halted是否被停售人工停的要人工放;低水位自动停的会在你充值后自动解除
self_pricing你能不能自己定零售价我方配置

⚠ 缺行 = 不可用(与产品授权那几张表刻意相反)。

没配过的线不是「不限制」,是「没开通」。

余额不足时,八条线的失败形态不一样

线余额不足时
remit · card进队列(pending_merchant_funds),你充值后自动继续
qrpay · exchange · earn · withdraw当场失败(service_unavailable),不排队
deposit · transfer不消耗预付,不受影响

⚠ 排队态里会员的钱一分没动。 它是冻结之前的状态 ——

否则钱会卡在一个会员自己推不动、运营也碰不到的桶里。

队列有多深


GET /v1/merchant/pending

给出每条线排了多少单、多少钱、最早一笔等了多久。

⚠⚠ 这是整条链上唯一能把「你该充值了」说清楚的地方。

会员侧的失败形态是「自己余额充足却交易失败」,而文案刻意不暴露原因。

不看这个端点的商户,只会看到成交率莫名其妙地下滑。

充值

两条路:

预付变动回调

备付金每次冻结、结算、解冻、直接扣款、入账、退回应付,都发merchant.balance.updated。用这一条记账。卡业务回调只说明卡到了哪一步,不带备付金金额。

data.status 是原因:

status含义
frozen可用减少、冻结等额增加
settled冻结结算。没花完的余量回到可用,amount 是净额
released解冻,含充值失败
debited直接扣可用(开卡费、消费手续费等,没有先冻结)。非自营商户的消费手续费在卡余额不足时,按 USD、USDT、USDC、USD1 以 1:1 扣对应资产的可用预付;asset 是实际扣到的资产。关联卡交易时 data.id 为 ctx_,请据此向自己的用户收费
credited入账,可用增加
refunded退回应付。可用和冻结此时不变
payable_settled应付划入可用。可用增加、应付等额减少,不是新的入金。销卡开卡费退款会在 refunded 之后再发这一条,data.id 仍是同一张申请单。商户提现被退回时也是这一条

金额都是该资产的定点整数字符串。available / frozen 是这笔之后的余额,available_delta / frozen_delta / payable_delta 是带符号的增量。data.id 是关联单号(申请单 cap_、充值单 ctp_ 或首充 first:、交易 ctx_、转出单 cwd_)。

相关端点