Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

金额的使用规则

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

字段

描述

currency

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

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. 货币最小单位

最低金额规则

对于 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