Перейти к содержанию

Курс валюты

Возвращает коммерческий курс банка-партнёра к UZS с учётом спреда (sell_rate/buy_rate). Используйте для отображения курса в интерфейсе. Для точного расчёта суммы конвертации применяйте «Конвертация (sell)» или «Конвертация (buy)».

URL

GET https://api.pay.kvell.group/v1/currency/rates

GET https://api.pay.stage.kvell.group/v1/currency/rates

Запрос

Query-параметры

Параметр Тип Обязательно Описание
ccy string Да Числовой код валюты ISO 4217, например "840" (USD). См. «Коды валют».

Заголовки

Название Тип Обязательно Описание
X-Api-Key string Да Идентификатор магазина.

Подпись X-Signature для этого метода не требуется.

Пример

curl --request GET \
  --url 'https://api.pay.stage.kvell.group/v1/currency/rates?ccy=840' \
  --header 'X-Api-Key: 00000000-0000-4000-8000-000000000000'

Ответ

Пример ответа 200 (OK)
{
  "currency": "840",
  "sell_rate": 12210,
  "buy_rate": 12155
}

Параметры ответа

Параметр Тип Описание
currency string Числовой код запрошенной валюты.
sell_rate number Цена продажи валюты банком, в UZS за 1 единицу валюты.
buy_rate number Цена покупки валюты банком, в UZS за 1 единицу валюты.

Что означает ответ

Курс актуален на момент ответа и может измениться при следующем запросе.

Что делать дальше

Используйте sell_rate/buy_rate для отображения курса. Для точного расчёта суммы перевода применяйте «Конвертация (sell)» или «Конвертация (buy)».

Пример ответа 404 (Not Found)
{
  "errors": [
    {
      "code": 20044,
      "message": "Интеграция с Montra не настроена для магазина"
    }
  ]
}

Параметры ответа

Параметр Тип Описание
errors array Список ошибок. Коды и рекомендации по обработке приведены в разделе «Ошибки HTTP-ответов».
errors[].code integer 20044 — интеграция не подключена; 20099 — курс для этой валюты недоступен у провайдера.
errors[].message string Описание причины.

Что означает ответ

Для кода 20044 обратитесь в поддержку KVELL, чтобы подключить интеграцию с провайдером курсов. Для кода 20099 проверьте код валюты в ccy.

Что делать дальше

Устраните причину ошибки и повторите запрос.

Пример ответа 422 (Unprocessable Entity)
{
  "errors": [
    {
      "code": 20098,
      "message": "ccy: Field required"
    }
  ]
}

Параметры ответа

Параметр Тип Описание
errors array Список ошибок валидации.
errors[].code integer Код ошибки.
errors[].message string Поле и причина ошибки валидации.

Что означает ответ

Не передан обязательный параметр ccy или он не соответствует формату.

Что делать дальше

Исправьте поле из errors[].message и повторите запрос.

Пример ответа 5XX (Internal Server Error)
{
  "errors": [
    {
      "code": 20000,
      "message": "Неизвестная ошибка"
    }
  ]
}

Параметры ответа

Параметр Тип Описание
errors array Список ошибок. Коды и рекомендации по обработке приведены в разделе «Ошибки HTTP-ответов».
errors[].code integer Код ошибки.
errors[].message string Описание технической ошибки.

Что означает ответ

Метод read-only и ничего не меняет — техническая ошибка не может привести к неопределённому результату.

Что делать дальше

Безопасно повторите тот же запрос. Если ошибка повторяется, обратитесь в поддержку KVELL и передайте URL, время запроса, HTTP-код, code и message.