金额的使用规则
接口和对账报告中都存在与币种相关的数据字段。其中 amount 对象被许多字段使用。字段 amount 包含子字段 currency 和 value:
字段 | 描述 |
currency | 必填 字符串(3) |
value | 必填 字符串(16) 以最小币种单位的正整数形式表示的金额值。例如,如果币种是 USD 金额是$1.00,则将此参数的值设置为 100。或者如果币种是 JPY,金额是¥1,则将此参数的值设置为1。 |
表 1. amount 对象的子字段
使用 amount 对象时,需要遵循使用规则以避免问题。
币种的最小单位
在 amout 字段的 value 字段中,实际值以币种的最小单位表示。Antom 遵循 ISO 4217 标准来定义币种的最小单位。例如:
货币代码 | 最小单位(小数点后位数) | 金额中的值 |
USD | 美分(2) | 1.00 USD 需设置为 "value:100" |
PHP | 美分(2) | 1.00 PHP 需设置为 "value:100" |
IDR | 美分(2) | 1.00 IDR 需设置为 "value:100" |
KRW | 元(0) | 1 KRW 需设置为 "value:1" |
THB | 分(2) | 1.00 THB 需设置为 "value:100" |
HKD | 分(2) | 1.00 HKD 需设置为 "value:100" |
MYR | 分(2) | 1.00 MYR 需设置为 "value:100" |
CNY | 分(2) | 1.00 CNY 需设置为 "value:100" |
BDT | 分(2) | 1.00 BDT 需设置为 "value:100" |
PKR | 分(2) | 1.00 PKR 需设置为 "value:100" |
TWD | 分(2) | 1.00 TWD 需设置为 "value:100" |
表 2. 货币最小单位
最低金额规则
对于 paymentAmount 或 refundAmount 字段,允许的最低金额因取决于支付方式。下表显示了每种支付方式的最低支付金额和最低退款金额的详细信息:
支付方式 | 最低支付金额 | 最低退款金额 |
TrueMoney | 1 THB | 1 THB |
AlipayHK | 0.01 HKD | 0.01 HKD |
Touch'n Go eWallet | 0.05 MYR | 0.05 MYR |
GCash | 1 PHP | 1 PHP |
DANA | 300 IDR | 300 IDR |
Kakao Pay | 50 KRW | 50 KRW |
JKOPay | 1 TWD | 1 TWD |