海外代收订单金额怎样统一:币种代码、金额单位与本地化显示
海外用户看到的价格、商户内部金额与通道请求字段,不一定使用同一表示方式。先确认币种与金额单位,再设计展示和接口适配。稳付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可以吗?
不应临时修正。保留原回调,核对该商户、通道与适配版本的真实单位,由技术团队确认后修复,防止把错误订单记成成功。