# Коды ошибок (API)

При ошибке обработки запроса API возвращает **HTTP 400** (или иной код ошибки метода) и JSON:


```json
{
  "error_code": 2
}
```

Поле `error_code` — целое число. Расшифровка и действия — в таблице ниже.

> Отказы по платежу на стороне банка/процессинга (`status_code` в колбеке) — в разделе [Коды ошибок (отказы)](/pages/decline-error-codes).


## Справочник `error_code`

| Код | Что означает | Что делать |
|  --- | --- | --- |
| `1` | Общая ошибка без детализации. | Обратитесь в поддержку 1Payment с `order_id` / `user_data` и временем запроса. |
| `2` | Неверная подпись `sign`. | Проверьте **ключ проекта** (не глобальный), префикс метода, сортировку параметров A→Z, MD5, lowercase (hex). Сверьте на [Формат запроса](/pages/init-request) или виджете подписи на странице метода. Не помогло — отправьте в поддержку исходную строку до MD5. |
| `3` | Метод недоступен. | Проверьте URL и имя метода; уточните у менеджера, подключён ли метод на проекте. |
| `4` | Партнёр не найден. | Проверьте `partner_id` в личном кабинете / у менеджера. |
| `5` | Проект не найден. | Проверьте `project_id` и привязку к `partner_id`. |
| `6` | Способ **приёма** не подключён к проекту. | Проверьте `payment_type` и договорённости по каналу (карта, СБП, СберПей). См. [Типы платежей](/pages/payment-types). |
| `7` | Способ **выплаты** не подключён к проекту. | Проверьте тип выплаты и настройки проекта. См. [Типы выплат](/pages/payout-types). |
| `8` | Ошибка `user_data`. | Передайте непустую строку до 255 символов; значение **уникально** в рамках `partner_id` (лучше UUID). Не повторяйте ID уже созданного платежа. |
| `9` | Недостаточно средств на балансе выплат. | Пополните баланс выплат или уменьшите сумму; уточните лимиты у менеджера. |
| `10` | Транзакция не найдена. | Проверьте `order_id` / `user_data` и `project_id`; убедитесь, что платёж создавался в этом проекте. |
| `11` | Оплата с данного источника недоступна. | Проверьте `shop_url`, домен и настройки проекта; при необходимости отправьте сайт на проверку через менеджера. |


## Связанные разделы

- [Коды ошибок (отказы)](/pages/decline-error-codes)
- [Формат запроса к API](/pages/init-request)