金额的使用规则
接口和对账报告中都存在与币种相关的数据字段。其中 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 |
PHP | 美分(2) | 1.00 |
IDR | 美分(2) | 1.00 |
KRW | 元(0) | 1 |
THB | 分(2) | 1.00 |
HKD | 分(2) | 1.00 |
MYR | 分(2) | 1.00 |
CNY | 分(2) | 1.00 |
BDT | 分(2) | 1.00 |
PKR | 分(2) | 1.00 |
TWD | 分(2) | 1.00 |
表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 |