Фиксация курса

Закрепление обменного курса фиата к криптовалюте в определённый момент, чтобы сумма в крипте, которую должен отправить клиент, не менялась, пока он платит.

#Как это работает в CryptoLike

Для платежа с ценой в фиате (currency: "USD") CryptoLike фиксирует курс в тот момент, когда становится известен актив: при создании, если вы передали coin_id, или когда плательщик выбирает актив на странице оплаты (POST /v1/checkout/{id}/coin). После этого в платеже заполнены rate_locked (рыночная котировка: сколько фиата стоит одна монета), rate_locked_at и amount_crypto (фиатная сумма по этому курсу без спреда конвертации, с округлением вверх до минимальной единицы монеты), и курс держится до ttl_expires_at. Подробнее — цена в долларах, оплата в криптовалюте.

До выбора страница оплаты показывает рядом с каждой монетой ориентировочную сумму со знаком ≈, рассчитанную так же, как была бы рассчитана фиксация в эту минуту. Оценка — ещё не фиксация: при выборе платёж пересчитывается, и только тогда курс закрепляется. После этого страница показывает зафиксированный курс и сколько минут он действует, рядом с суммой к отправке. Если в момент фиксации свежего курса нет, запрос отвечает 503 unavailable: повторите позже или создайте платёж в крипте. У платежа с ценой в крипте фиксировать нечего, и rate_locked остаётся null.

Зафиксированный курс не пересчитывается. После истечения срока новый платёж получает новый курс, а средства, пришедшие позже, зачисляются по фактически полученной сумме в крипте. Если ваши цены в долларах, платежи в стейблкоинах обходятся без пересчёта вовсе.

#Пример

Платёж CryptoLike с ценой в долларах и активом, выбранным при создании: курс фиксируется уже в ответе, а amount_crypto — точная сумма, которую ждёт адрес. Если не передавать coin_id, фиксация произойдёт позже — в момент, когда плательщик выберет актив на странице оплаты из доступных вариантов:

{
  "amount": "49.90",
  "currency": "USD",
  "coin_id": "6f1c2a3e-8d4b-4c5a-9e7f-0a1b2c3d4e5f",
  "order_id": "10042"
}