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. And all currency fields of Alipay APIs or 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. (That is, 100 cents to charge $1.00, or 100 to charge JPY ¥100, a zero-decimal currency).

    Table 1. Subfields 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.