Авторизация запросов

На этой странице описаны методы авторизации запросов к Merchant API и общий формат ошибок.

API KEY

В каждом запросе к API необходимо передавать HTTP-заголовок: Authorization: Bearer <YOUR-API-KEY>.

<YOUR-API-KEY> - ваш личный токен мерчанта, который будет сообщен при интеграции (см. страницу "Процесс интеграции").

Формат ошибок

Тело ответа при ошибке - плоский JSON без человекочитаемого поля:

{
  "errorCode": "order_limits_exceeding",
  "params": {
    "min": "100",
    "max": "10000"
  }
}

Поле	Тип	Обязательное	Описание
errorCode	string	да	Код ошибки
params	object	нет	Параметры ошибки

HTTP-коды ответов

Код	Ситуация
400	Невалидные параметры или бизнес-отказ (уточняет errorCode)
401	Токен отсутствует или невалиден
403	Доступ запрещён
404	Ордер не найден
409	Дубликат merchantOrderID
5xx	Внутренняя ошибка сервера

Коды ошибок

errorCode	HTTP	Значение
unauthorized	401	Токен отсутствует или невалиден
forbidden	403	Доступ запрещён
order_not_found	404	Ордер не найден
invalid_request_parameters	400	Параметры не прошли валидацию
no_active_merchant_method	400	Метод не активирован для мерчанта
no_payment_details_available	400	Не удалось выдать реквизиты
order_limits_exceeding	400	Сумма вне лимитов метода
turnover_limits_exceeding	400	Превышены лимиты оборота мерчанта
client_id_in_blacklist	400	Клиент в чёрном списке
not_enough_money_on_balance	400	Недостаточно USDT (PayOut)
duplicate_merchant_order_id	409	merchantOrderID уже использован
internal_error	500	Внутренняя ошибка