金额的使用规则
接口中存在与币种相关的数据字段。其中 amount 对象被许多字段使用。字段 amount 包含子字段 currency 和 value:
字段 | 描述 |
currency | 必填 字符串(3) |
value | 必填 字符串(16) 以最小币种单位的正整数形式表示的金额值。 如果币种是 USD 金额是 $1.00,则将此参数的值设置为 |
使用 amount 对象时,需要遵循使用规则以避免问题。
币种的最小单位
在 amount 字段的 value 字段中,实际值以币种的最小单位表示。Antom 遵循 ISO 4217 标准来定义币种的最小单位。例如:
货币代码 | 最小单位(小数点后位数) | 金额中的值 |
AUD | 2 位小数 | 1.00 AUD 需设置为 "value: 100" |
BDT | 2 位小数 | 1.00 BDT 需设置为 "value: 100" |
BRL | 2 位小数 | 1.00 BRL 需设置为 "value: 100" |
CAD | 2 位小数 | 1.00 CAD 需设置为 "value: 100" |
CLP | 0 位小数 | 1 CLP 需设置为 "value: 1" |
CNY | 2 位小数 | 1.00 CNY 需设置为 "value: 100" |
EUR | 2 位小数 | 1.00 EUR 需设置为 "value: 100" |
GBP | 2 位小数 | 1.00 GBP 需设置为 "value: 100" |
HKD | 2 位小数 | 1.00 HKD 需设置为 "value: 100" |
IDR | 2 位小数 | 1.00 IDR 需设置为 "value: 100" |
JPY | 0 位小数 | 1 JPY 需设置为 "value: 1" |
KRW | 0 位小数 | 1 KRW 需设置为 "value: 1" |
MXN | 2 位小数 | 1.00 MXN 需设置为 "value: 100" |
MYR | 2 位小数 | 1.00 MYR 需设置为 "value: 100" |
NZD | 2 位小数 | 1.00 NZD 需设置为 "value: 100" |
PEN | 2 位小数 | 1.00 PEN 需设置为 "value: 100" |
PHP | 2 位小数 | 1.00 PHP 需设置为 "value: 100" |
PKR | 2 位小数 | 1.00 PKR 需设置为 "value: 100" |
PLN | 2 位小数 | 1.00 PLN 需设置为 "value: 100" |
SGD | 2 位小数 | 1.00 SGD 需设置为 "value: 100" |
THB | 2 位小数 | 1.00 THB 需设置为 "value: 100" |
TWD | 2 位小数 | 1.00 TWD 需设置为 "value: 100" |
USD | 2 位小数 | 1.00 USD 需设置为 "value: 100" |
VND | 0 位小数 | 1 VND 需设置为 "value: 1" |
注意:
- 支付方式 JKOPay 支持传入台币(TWD),传入的参数值必须确保末两位为 00 且为 100 的整数倍。例如:传入的参数值为
100时, 代表 1 台币。注意不能传入110或者101来代表 1.1 台币或 1.01 台币。- 支付方式 Octopus 支持传入港币(HKD),传入的参数值必须确保末位为 0 且为 10 的整数倍。例如: 传入的参数值为
100时,代表 1 港币;传入的值为110时,代表 1.1 港币 。注意不能传入101来代表 1.01 港币。- 根据印度尼西亚货币惯例,IDR 币种的参数值必须确保末两位为 00 且为 100 的整数倍。例如:参数值可传入为
100/1000/10000,但不能传入1001/1010等。此外,不同的支付方式有最小金额限制,例如 DANA 支持传入的最小金额为 300 IDR。
最低金额规则
对于 paymentAmount 或 refundAmount 字段,允许的最低金额因取决于支付方式。每种支付方式的最低支付金额和最低退款金额有所不同,请根据具体支付方式的限额规则来传入参数值。