Antom, leading provider of tailored payment solutionsAntom, leading provider of tailored payment solutions

金额的使用规则

接口和对账报告中都存在与币种相关的数据字段。其中 amount 对象被许多字段使用。字段 amount 包含子字段 currencyvalue

字段

描述

currency

必填 字符串(3)
币种代码,值为遵循 ISO 4217 标准的三位币种代码。

value

必填 字符串(16)

以最小币种单位的正整数形式表示的金额值。例如,如果币种是 USD 金额是$1.00,则将此参数的值设置为 100。或者如果币种是 JPY,金额是¥1,则将此参数的值设置为1

表 1. amount 对象的子字段

使用 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 MYR 需设置为 "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 PKR 需设置为 "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"

表 2. 货币最小单位

最低金额规则

对于 paymentAmountrefundAmount 字段,允许的最低金额因取决于支付方式。下表显示了每种支付方式的最低支付金额和最低退款金额的详细信息:

支付方式

最低支付金额

最低退款金额

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

表 3. 支付方式的最低金额