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

Курс ЦБ РУз (одна валюта)

Возвращает официальный курс Центрального банка Республики Узбекистан для одной валюты. В отличие от «Курс валюты», это референсный курс без спреда — используйте для отображения официального курса и бухгалтерии, не для фактической конвертации сумм.

URL

GET https://api.pay.kvell.group/v1/currency/cbu/rate

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

Запрос

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/cbu/rate?ccy=840' \
  --header 'X-Api-Key: 00000000-0000-4000-8000-000000000000'

Ответ

Пример ответа 200 (OK)
{
  "code": "840",
  "ccy": "USD",
  "name_ru": "Доллар США",
  "name_en": "US Dollar",
  "nominal": 1,
  "rate": 12065.49,
  "diff": -27.38,
  "date": "15.07.2026",
  "date_iso": "2026-07-15"
}

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

Параметр Тип Описание
code string Числовой код валюты ISO 4217.
ccy string Буквенный код валюты ISO 4217, например "USD".
name_ru string Название валюты на русском.
name_en string Название валюты на английском.
nominal integer За сколько единиц валюты указан rate.
rate number Курс в UZS за nominal единиц валюты.
diff number Изменение курса к предыдущему дню.
date string Дата курса в формате дд.мм.гггг.
date_iso string Дата курса в формате гггг-мм-дд.

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

Курс ЦБ РУз обновляется раз в сутки.

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

Используйте rate для отображения официального курса.

Пример ответа 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.