Data types — [Archive] Payment solution protocol for merchants

Data types

This is an old version of the API. Switch to the YooMoney API.

Type	Description
int	32-bit signed integer
long	64-bit signed integer
boolean	Logical value (`true` or `false`)
string	UTF‑8 encoded text string
normalizedString	Text string in UTF‑8 encoding, without line break, carriage returns, or tab symbols
dateTime	Temporary tag conforming to the RFC3339 standard in the following format: `YYYY-MM-DDThh:mm:ss.fZZZZZ` Format breakdown: `YYYY` — Year, exactly 4 digits; `MM` — Month, 2 digits exactly (`01` for January, and so on); `DD` — Day of the month, exactly 2 digits (from 01 to 31); `T` — Latin uppercase “T” character; `hh` — Hour, exactly 2 digits (24-hour format, from 00 to 23); `mm` — Minute, exactly 2 digits (from 00 to 59); `ss` — Second, exactly 2 digits (from 00 to 59); `f` — Fraction of a second (from 1 to 6 digits). May be omitted. In this case, omit the dot separator (.); `ZZZZZ` — Time zone. Acceptable values: `Z` — UTC, uppercase “Z” character; `+ hh:mm` or `-hh:mm` — Offset relative to UTC (GMT). Shows that the local time is used, which is ahead of or behind UTC the given number of hours and minutes. Example: `2019-07-01T19:00:00.000+03:00` — 7 p.m. on July 1, 2019, Europe/Moscow time zone (UTC+03:00).
YMAccount	YooMoney virtual account number. String of decimal digits from 11 to 33 digits long.
CurrencyAmount	Amount. Fixed-point decimal number with 2-digit precision.
CurrencyCode	Unsigned integer. Currency code. Fixed value: `643` — Russian ruble.
CurrencyBank	Unsigned integer. Code of the YooMoney processing center. Fixed value: `1001` — Ecombank.
ClientTransactionNumber	Unique transaction ID. Must be unique for the merchant over the entire history of operations. The parameter value must be a string containing from 1 to 24 characters. Allowed characters: `0-9 A-Z a-z . , \ \| / - + =` `#` `~ ( ) { } [ ] : ;`. Recommended values: positive decimal integers in increasing order.