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) |
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