金额的使用规则

2026-10-27 14:02

接口中存在与币种相关的数据参数。其中 amount 对象被许多接口使用，包含 currency 和 value 两个子参数：

参数	描述
currency	必填字符串（3）币种代码，值为遵循 ISO 4217 标准的三位币种代码。
value	必填字符串（16）以最小币种单位的正整数形式表示的金额值。如果币种是 USD 金额是 $1.00，则将此参数的值设置为 100。或者如果币种是 JPY，金额是 ¥1，则将此参数的值设置为 1。

使用 amount 对象时，需要遵循使用规则以避免问题。

币种的最小单位

amount.value 表示金额，需按对应币种的最小单位传入。Antom 遵循 ISO 4217 标准来定义币种的最小单位。例如：

注意：

传入台币（TWD）时，支付方式 JKOPay 不支持传入小数，传入的参数值必须确保后两位为 00 且为 100 的整数倍。例如：传入的参数值为 100 时，代表 1 台币。不能传入 110 或者 101 来代表 1.1 台币或 1.01 台币。
传入港币（HKD）时，支付方式 Octopus 传入的参数值必须确保末位为 0 且为 10 的整数倍。例如：传入的参数值为 100 时，代表 1 港币；传入的值为 110 时，代表 1.1 港币。不能传入 101 来代表 1.01 港币。
根据印度尼西亚货币惯例，IDR 币种的参数值必须确保末两位为 00 且为 100 的整数倍。例如：参数值可传入为 100/1000/10000，但不能传入 1001/1010 等。此外，不同的支付方式有最小金额限制，例如 DANA 支持传入的最小金额为 300 IDR。

对于 paymentAmount 或 refundAmount，允许的最低金额因取决于支付方式。每种支付方式的最低支付金额和最低退款金额有所不同，请根据具体支付方式的限额规则来传入参数值。