预付账户、授信、低水位 —— 三个数决定你的业务什么时候会停。
商户账户与预付
所有成本都从预付里扣
我方不帮商户垫一分钱。你的每一笔业务在成交之前,我方要向你收的那部分会先从预付账户里冻结,成交时结算。
预付余额 ──冻结──► 冻结中 ──结算──► 我方收入
▲ │
└────── 释放 ────────┘ (订单取消/失败)
预付是逐资产的: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
给出每条线排了多少单、多少钱、最早一笔等了多久。
⚠⚠ 这是整条链上唯一能把「你该充值了」说清楚的地方。
会员侧的失败形态是「自己余额充足却交易失败」,而文案刻意不暴露原因。
不看这个端点的商户,只会看到成交率莫名其妙地下滑。
充值
两条路:
- 链上充值 —— 用
POST /v1/merchant/deposit-addresses取一个我方分配给你的地址,转过来即可。到账后自动入账(地址是我方分配的、金额来自链上确认,没有一处需要人手输数字)。 - 线下结算 —— 银行汇款,我方人工核对回单后双人审批入账。
预付变动回调
备付金每次冻结、结算、解冻、直接扣款、入账、退回应付,都发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_)。