Справочник ошибок

Ответ с ошибкой — JSON с ненулевым code и английским message; HTTP-статус соответствует классу ошибки. Для 500 в ответ добавляется trace_id: укажите его в обращении в поддержку. У ошибки 400 с кодом 3 есть поле details — список претензий к телу запроса. Синтаксически неверный JSON отклоняется ещё до проверки ключа: 400, код 3, в details — invalid_json.

{ "code": 16, "message": "Transfers are not available for this organization." }

HTTP	code	Сообщение	Что делать
500	1	Internal server error.	Повторить с тем же Idempotency-Key; если повторяется — в поддержку с trace_id
400	3	Invalid input, check schema issues.	Проверить тело запроса по описанию метода
404	12	API method not found, check the URL.	Проверить путь и метод POST
403	13	This section is not available from a personal account. Use a business organization API key.	Использовать ключ бизнес-организации
403	16	Transfers are not available for this organization.	Переводы выключены, организация удалена или обслуживается через дистрибьютора — к менеджеру
404	17	Recipient not found.	Проверить user_id. В методах работы с клиентами тот же код, если пользователь не ваш клиент
400	18	Transfer to the organization owner account is not allowed.	Получатель не может совпадать с отправителем
422	19	Insufficient funds on the organization balance.	Пополнить баланс организации
409	20	Idempotency-Key was already used with a different request body.	На новую операцию — новый ключ
400	21	Idempotency-Key header is required, 8-64 chars of [A-Za-z0-9_-].	Добавить заголовок. У возврата предел короче, и сообщение называет его: 8-60 chars
403	22	This API key is not allowed to make transfers. Enable transfers for the key in the account settings.	Включить тумблер «Переводы» в настройках ключа. Тумблера нет — попросить менеджера включить переводы организации. Личный ключ переводить не может
404	23	Recipient account is deleted.	Получатель удалил аккаунт
404	24	Recipient organization not found.	Проверить org_id. В методах работы с клиентами тот же код, если организация не ваш клиент
404	25	Recipient organization is deleted.	Организация-получатель удалена
403	27	Creating recipients via user_data is not available for this organization.	Поиск по телефону не подключён — передавать user_id или org_id
403	32	Organization creation is not enabled for this organization.	Попросить менеджера включить создание организаций
403	33	Creating owners via phone is not available for this organization.	Назначать владельца по user_id
403	34	Balance view is not available for this organization.	balance/get организации не подключён — к менеджеру
403	35	Balance refund is not available for this organization.	balance/refund не подключён, у организации выключены переводы или она обслуживается через дистрибьютора — к менеджеру
403	36	Listing user organizations is not available for this organization.	orgs/list организации не подключён — к менеджеру
422	37	Insufficient funds on the client balance.	На счёте клиента меньше суммы возврата — уменьшить сумму
422	38	Amount exceeds the unreturned transfers to this client.	Вернуть можно не больше ещё не возвращённых переводов клиенту
409	39	Concurrent operation on this organization, retry with the same Idempotency-Key.	Повторить запрос с тем же Idempotency-Key
403	40	Spending view is not available for this organization.	balance/spending организации не подключён — к менеджеру
409	41	An organization with this OGRN is already registered.	Организация с таким ОГРН уже есть
409	42	An organization with this INN is already registered.	Организация с таким ИНН уже есть

Ответ 401

Если ключ не принят, ответ приходит со статусом 401 и в другом формате — без числового code верхнего уровня, ошибка лежит в объекте error:

{
  "error": {
    "message": "API key has expired. Extend its expiration date or create a new key.",
    "type": "unauthorized_request_error",
    "param": null,
    "code": "api_key_expired"
  }
}

error.code	Когда
api_key_expired	Истёк срок действия ключа — продлите его в настройках ключа или создайте новый
api_key_revoked	Ключ удалён
null	Ключ не передан или не найден, либо его владелец больше не сотрудник организации