Currency codes

Currency-related data fields exist for both APIs and reconciliation reports. One of them is the payment amount that is presented by the amount field. The amount field has sub-fields of currency and value. All currency fields in Alipay APIs and reports follow the same definition.


#Amount

Field

Description

currency

MANDATORY String (3)
The 3-letter currency code that follows the ISO 4217 standard.

value

MANDATORY String (16)

The amount to charge as a positive integer in the smallest currency unit. For example, $1.00 should be charged as 100 cents to charge USD 1.00, or 100 to charge JPY 100, a zero-decimal currency.

Table 1. Sub-fields of the amount field


Note:

The actual value in the value field of the amount field is represented in the smallest unit of the currency. Alipay follows the ISO 4217 standard for the definition of the smallest unit of a currency. For example:

Currency Code

Smallest Unit (Number of the Digits after Decimal)

Value in the Amount

USD

cent (2)

1.00 USD needs to be set as "value:100"

PHP

cent (2)

1.00 PHP needs to be set as "value:100"

IDR

cent (2)

1.00 IDR needs to be set as "value:100"

KRW

yuan (0)

1 KRW needs to be set as "value:1"

THB

cent (2)

1.00 THB needs to be set as "value: 100"

HKD

cent (2)

1.00 HKD needs to be set as "value: 100"

MYR

cent (2)

1.00 MYR needs to be set as "value: 100"

CNY

cent (2)

1.00 CNY needs to be set as "value: 100"

BDT

cent (2)

1.00 BDT needs to be set as "value: 100"

PKR

cent (2)

1.00 PKR needs to be set as "value: 100"

Table 2. Details about the currency