海外代收訂單金額怎樣統一:幣種代碼、金額單位與本地化顯示

海外用戶看到的價格、商戶內部金額與通道請求字段,不一定使用同一表示方式。先確認幣種與金額單位,再設計展示和接口適配。稳付pay海外地區及D0安排以已確認方案為準;公開代收示例不代表每個海外通道都采用同一單位,需技術團隊逐通道確認。

按主題繼續閱讀

一、金額必須同時帶有幣種和單位

訂單保存明確幣種代碼、內部金額單位、精度及報價版本,不只留一個沒有上下文的“1000”。同一商戶可有多幣種訂單,但每張單的原始幣種與金額應固定。缺失幣種、單位不明或超出實際開通範圍時,在下單前拒絕,不自動補成人民幣或USDT。

主單位、輔單位和代幣最小單位是不同概念。某幣種展示的小數位不自動決定上游字段單位,也不能從國家名稱推斷接口精度。接入確認單應逐通道寫明請求、查詢和回調各自的單位及舍入規則;有矛盾先確認,不靠樣例猜。

二、頁面格式只負責展示,不能倒灌成協議金額

頁面可用本地化數字格式顯示價格,讓用戶看清幣種與分隔符。但“1,000”“1.000”和包含空格的數字,在不同習慣下含義可能不同。不要去掉所有標點就發給通道,也不要把已經格式化的價格字符串當作後端真實金額。

服務端從可信商品與報價生成標準內部值,再按已確認協議編碼。需要十進制運算時使用明確精度的十進制或整數單位,避免二進制浮點的相等比較誤差;輸入同時限制符號、範圍、位數與幣種。展示API不替你確定業務計價和請求規則。

三、用單向適配和凍結報價消除百倍錯誤

演示:內部記錄某USD訂單為主單位10.50;只有通道協議明確要求“分”時,才編碼成整數1050。若協議要求主單位字符串,則仍按其規定發送10.50。不能把其中一種編碼復制到VND、INR或另一條USD通道;這些數字僅示意單位轉換。

保留原內部值、通道值、單位與適配版本,查詢和回調反向轉換後再按原訂單核對。支付鏈接創建後,即使網站切換顯示語言或商品價格變化,也不重解釋舊單。發現返回值看似差100倍,先保持待核對並保存原文,不自動放寬金額校驗。

四、原幣種、USDT和用戶權益分別對賬

原幣種賬記錄客戶付款、費用、退款及待結算;USDT賬記錄已確認換算、轉賬和實收,兩者通過結算事項關聯,不能直接相減,也不能默認USD與USDT按一比一結算。D0不決定金額單位、匯率或固定到賬分鐘數。

用戶獲得的書幣、點數、流量或會員另按原商品快照交付,不用錢包USDT數量倒推。用自有測試資料覆蓋本地化分隔符、零值、負值、超精度、幣種缺失、單位沖突和顯示語言切換。驗收能從頁面價格追到原訂單、實際支付值與結算記錄,才適合上線。

常見問題

瀏覽器顯示兩位小數,就代表接口金額一定是分嗎?

不是。格式化顯示、幣種常用精度與實際接口單位分別確認,不能僅從小數位或地區推斷。

回調金額與本地差100倍,自動除100可以嗎?

不應臨時修正。保留原回調,核對該商戶、通道與適配版本的真實單位,由技術團隊確認後修復,防止把錯誤訂單記成成功。

參考資料