Валюты
Поддерживаемые валюты и мультивалютная схема операций
Поддерживаемые валюты
| Код | Описание |
|---|---|
RUB | российский рубль |
USDT | Tether |
USD | доллар США |
EUR | евро |
KZT | казахстанский тенге |
UZS | узбекский сум |
AZN | азербайджанский манат |
ARS | аргентинское песо |
BOB | боливиано |
BRL | бразильский реал |
CLP | чилийское песо |
COP | колумбийское песо |
GYD | гайанский доллар |
PYG | парагвайский гуарани |
PEN | перуанский соль |
SRD | суринамский доллар |
UYU | уругвайское песо |
VES | венесуэльский боливар |
FKP | фолклендский фунт |
Значение NOTSET зарезервировано платформой и в ответах для мерчанта не встречается.
Валюты в учётной модели мерчанта
В учётной модели для мерчанта определены две валюты:
currencyPayment— валюта операции, в которой выполняется взаимодействие с конечным клиентом мерчанта;currencyBalance— валюта балансового счёта мерчанта на платформе.
Сочетание currencyPayment и currencyBalance определяется при создании мерчанта и не подлежит изменению без согласования с платформой.
Суммы операции
Каждая операция содержит четыре связанных суммы:
| Поле | Валюта | Описание |
|---|---|---|
amount | currency (= currencyPayment) | сумма операции в валюте платежа |
amountComission | currency | комиссия в валюте платежа |
amountInCurrencyBalance | currencyBalance | сумма операции в валюте баланса |
amountComissionInCurrencyBalance | currencyBalance | комиссия в валюте баланса |
exchangeRate | — | курс пересчёта currencyPayment → currencyBalance |
Момент фиксации курса
Момент фиксации курса зависит от валютной пары:
| Валютная пара | Момент фиксации курса |
|---|---|
USDT ↔ USDT | в момент создания операции, курс равен 1 |
USDT → RUB (Pay Out) | для мерчанта и платформы — в момент создания; для провайдера — в момент settlement |
RUB → USDT (Pay In) | для мерчанта и платформы — в момент merchant settle; для провайдера — в момент создания |
RUB ↔ RUB | курс равен 1, схема фиатного учёта |
До момента фиксации курса значение amountInCurrencyBalance для операций Pay In с пересчётом валют отражает предварительную оценку и подлежит обновлению.
Округление
Все суммы округляются до четырёх знаков после десятичного разделителя. Передача значений с большей точностью не приводит к ошибке валидации; младшие разряды отбрасываются.
Применение в интерфейсах мерчанта
| Сценарий | Применяемые поля |
|---|---|
| Отображение суммы заказа конечному клиенту | amount и currency |
| Отображение баланса мерчанта | amountInCurrencyBalance и currencyBalance |
| Расчёт чистой выручки мерчанта | amount − amountComission или amountInCurrencyBalance − amountComissionInCurrencyBalance |