手续费如何计算、资金何时入账、余额的四个口径。
手续费 = round(订单金额 × 费率 + 固定费用)
入账净额 = 订单金额 - 手续费默认费率 3.5% + $0.30,按商户可配,签约时确定。金额一律是整数最小货币单位(美分),不要传小数。
以一笔 $29.90 的订单为例:
amount = 2990
fee = round(2990 × 0.035 + 30) = 135
net_amount = 2990 - 135 = 2855订单对象上的 fee 和 net_amount 在支付成功入账后才有值,未支付时都是 0。
支付成功即入账,没有账期。资金进入你的可用余额,可以立即用于退款或发起提现。
入账只以上游通道的确认为准。收银台页面显示成功、买家浏览器回跳,都不会直接入账——平台会向通道回读这笔支付,核对金额与币种一致后才记账。这意味着即使买家关掉了页面,钱也不会丢。
沙箱环境初始赠送 $5,000.00 虚拟体验金,用于联调退款与提现流程。它不是真实资金,也无法提现到银行账户。
余额接口 返回的字段含义:
| 字段 | 含义 |
|---|---|
available_balance | 可提现余额。存在未结案拒付时可能为负 |
frozen_balance | 冻结余额:在途退款与未结案拒付占用 |
total_revenue | 累计收单金额(订单原始金额,未扣费) |
total_fee | 累计手续费 |
total_refund | 累计退款金额 |
total_payout | 累计提现金额 |
available_balance 是当前状态的快照。想知道"它是怎么变成现在这样的",用 资金流水——那里每一笔变动各记一行,加起来就是余额的变化,是做每日对账最合适的口径。
退款分两个阶段,因为通道确认退款需要时间:
available 移入 frozen(refund_freeze)。钱还没退出去,但已经被锁定,不能提现。frozen 真实扣账(refund_debit);通道拒绝则解冻退回(refund_unfreeze)。只有真实扣账后才会推送 refund.succeeded。接口返回 202 且 status 为 pending 时,不要告诉买家钱已经退回去了。
沙箱与正式的余额、账本、银行账户完全独立,各自记一套。测试密钥永远看不到正式资金,反之亦然。