Money

  • The content defines a JSON representation for an amount of money, including its currency type.

  • The JSON object for money includes fields for currencyCode, units, and nanos.

  • currencyCode is a three-letter ISO 4217 code for the currency.

  • units represents the whole amount of money.

  • nanos represents the fractional part of the amount in nano units.

Represents an amount of money with its currency type.

JSON representation
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Fields
currencyCode

string

The three-letter currency code defined in ISO 4217.

units

string (int64 format)

The whole units of the amount. For example if currencyCode is "USD", then 1 unit is one US dollar.

nanos

integer

Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If units is positive, nanos must be positive or zero. If units is zero, nanos can be positive, zero, or negative. If units is negative, nanos must be negative or zero. For example $-1.75 is represented as units=-1 and nanos=-750,000,000.