費率與結算

手續費

手續費 = min(round(訂單金額 × 渠道費率 + 該幣種的固定費), 訂單金額)
入賬淨額 = 訂單金額 - 手續費

費率按支付渠道和幣種分別定價：買家實際使用的支付方式決定走哪個渠道的比例費率，訂單幣種決定固定費。

平台標準價如下，簽約時可以按渠道和幣種單獨商定，並在商戶控制台「資質入駐」頁查看：

金額一律是整數最小貨幣單位（如美分），不要傳小數。手續費不會超過訂單金額：固定費大於訂單金額的小額訂單入賬淨額為 0，但照常入賬。

以一筆 $29.90、買家用信用卡支付的訂單為例（標準價）：

amount      = 2990
fee         = round(2990 × 0.035 + 30) = 135
net_amount  = 2990 - 135 = 2855

訂單對象上的 fee 和 net_amount 在支付成功入賬後才有值，未支付時都是 0。fee_details 記錄這筆實際按哪一檔計費，之後調整費率不會改變已入賬訂單的手續費：

"fee_details": { "fee_group": "card", "fee_percent": 0.035, "fixed_fee": 30 }

什麼時候入賬

支付成功並經上游確認後，訂單淨額進入賬面可用餘額，可用於退款。正式環境提現還要等待上游資金變為可用並完成對賬；未清算的金額不會計入 withdrawable_balance。

入賬只以上游通道的確認為準。收銀台頁面顯示成功、買家瀏覽器回跳，都不會直接入賬——平台會向通道回讀這筆支付，核對金額與幣種一致後才記賬。這意味着即使買家關掉了頁面，錢也不會丟。

餘額口徑

餘額接口 返回的字段含義：

available_balance 是當前狀態的快照。想知道"它是怎麼變成現在這樣的"，用 資金流水——那裏每一筆變動各記一行，加起來就是餘額的變化，是做每日對賬最合適的口徑。

退款對資金的影響

退款分兩個階段，因為通道確認退款需要時間：

1. 受理——金額從 available 移入 frozen（refund_freeze）。錢還沒退出去，但已經被鎖定，不能提現。
2. 確認——通道確認後從 frozen 真實扣賬（refund_debit）；通道拒絕則解凍退回（refund_unfreeze）。

只有真實扣賬後才會推送 refund.succeeded。接口返回 202 且 status 為 pending 時，不要告訴買家錢已經退回去了。

環境隔離

沙箱與正式的餘額、賬本、銀行賬戶完全獨立，各自記一套。測試密鑰永遠看不到正式資金，反之亦然。