# Банки и приём платежей Банки и кассы подключаются в разделе **«Интеграции»**. Общие правила (виды подключения, статусы карточки, «Только чтение», отключение) описаны на странице [«Подключение сервисов»](/help/integrations). Как агент спрашивает перед изменениями, рассказано в [«Как агент меняет данные»](/help/trust). Агент работает с правами того пользователя или ключа, который вы подключили. Ключ или токен банка открывает доступ к счетам: храните его как пароль. Подпись и отправка платежей остаются за вами в интернет-банке. ## Т-Банк Бизнес Счета, выписки, платежи, зарплата и карты. Подробнее на [странице интеграции](/integrations/tinkoff). ### Что умеет агент Читает счета, балансы и выписки, разбирает операции по контрагентам и статьям. Платёжное поручение готовит, если права пользователя это позволяют, подпись и отправка остаются в банке. ### Что нужно заранее Номер телефона, к которому в Т-Бизнесе привязан доступ к компании. Токены копировать не нужно. ### Шаги ### Нажмите «Подключить через Т-Банк» В разделе «Интеграции» откройте карточку **«Т-Банк Бизнес»** и нажмите **«Подключить через Т-Банк»**. ### Войдите в Т-Бизнес Войдите на business.tbank.ru по номеру, к которому привязан доступ к компании. Если на номер оформлено несколько компаний, сверьте ИНН нужной. ### Подтвердите доступ После подтверждения подключение подписано названием компании. ### Какие права выдать - **Уровень доступа.** В **«Настройки профиля и доступы» → «Компания» → «Пользователи»** три уровня: «Директор», «Подписант», «Менеджер». Менять уровни может только «Директор», поэтому подключать лучше под ним. - **Счета.** Доступ настраивается по каждому счёту отдельно: на главной выберите счёт → **«Настройки» → «Доступ к счету»**, отметьте пользователя → **«Сохранить»**. Неотмеченный счёт агент не увидит. ### Ограничения - Операции по счетам доступны начиная с июня 2023 года, более ранние выписки выгружайте из интернет-банка вручную. - Несколько компаний на одном номере подключаются отдельно. В запросе называйте нужную: «по счетам ООО …, а не ИП». ### Как отозвать доступ Нажмите **«Отключить»** в карточке у нас. В Т-Бизнесе снимите отметку пользователя в «Доступе к счету» или поменяйте его уровень. ### Неполадки - **Агент видит не все счета**: счёт не отмечен в «Доступе к счету». - **Статус «Требуется переподключение»**: нажмите **«Переподключить»** и войдите заново. ## СберБизнес Счета, выписки, платежи, контрагенты, корпоративные карты и зарплата через Sber API. Подробнее на [странице интеграции](/integrations/sberbank). ### Что умеет агент Читает счета и выписки, справочник контрагентов, карты и зарплатные данные в пределах прав, которые вы выбрали при подключении Sber API. ### Что нужно заранее - Доступ к СберБизнесу у руководителя (ЕИО) или пользователя с доверенностью: он подписывает заявление на Sber API. - Возможность выпустить TLS-сертификат и сохранить его с ключом в формате PEM. - Зарегистрированный адрес перенаправления (Redirect URI) из параметров сервиса. ### Шаги У Сбера путь длиннее, чем у других банков: банк выдаёт доступ только по своему сертификату и одноразовому коду. ### Подключите Sber API в СберБизнесе **«Все продукты и услуги» → «Сбербанк API» → «Sber API» → «Подключить»**. Выберите права. Заявление подписывает руководитель или пользователь с доверенностью. ### Активируйте сервис и скопируйте параметры После активации откройте **«Параметры промышленного сервиса»**: там Client ID, Client Secret и Redirect URI. Сохраните и scope, он понадобится для авторизации. ### Выпустите сертификат В **«Сертификатах шифрования»** выпустите TLS-сертификат для своего Client ID. Если банк отдал контейнер .p12, заранее экспортируйте из него отдельно сертификат и приватный ключ в PEM. Ключ должен быть незашифрованным. ### Заполните форму В карточке **«СберБизнес»** заполните **«ID клиента»** (Client ID), **«Секрет клиента»** (Client Secret), загрузите **«Клиентский сертификат»** и **«Приватный ключ сертификата»**, укажите **«Адрес перенаправления»** (тот же зарегистрированный Redirect URI). Поле **«Код авторизации»** пока оставьте пустым. ### Пройдите авторизацию СберБизнеса Откройте в браузере `https://sbi.sberbank.ru:9443/ic/sso/api/v2/oauth/authorize` с параметрами `response_type=code`, `client_id`, `redirect_uri` (тот же адрес, что в форме), `scope` (в него входит `openid`) и случайными `state` и `nonce`, и войдите. Банк вернёт вас на Redirect URI, в адресе будет параметр code. ### Вставьте код и сразу подключите Скопируйте значение code в поле **«Код авторизации»** и сразу нажмите **«Подключить»**: код одноразовый и быстро истекает. ### Какие права выдать Те, что вы отметили при подключении Sber API на первом шаге. Агент увидит только разрешённое ими: если нужны выписки, права на счета и выписки обязательны. ### Ограничения - Сертификат должен относиться к тому же Client ID, что и в форме, а приватный ключ соответствовать сертификату. - Код авторизации годится один раз. Если подключение не прошло, получите новый код и вставьте его. ### Как отозвать доступ Нажмите **«Отключить»** в карточке у нас. Права самого сервиса Sber API живут в СберБизнесе, в разделе «Сбербанк API». ### Неполадки - **Подключение отклонило код**: код истёк или уже использован. Пройдите авторизацию заново и нажмите «Подключить» сразу после вставки. - **Ошибка сертификата**: сертификат выпущен для другого Client ID, ключ зашифрован или не подходит к сертификату. Экспортируйте пару из .p12 заново. ## Точка Банк Счета, выписки, платежи и СБП. Подробнее на [странице интеграции](/integrations/tochka). ### Что умеет агент Читает счета и выписки, готовит платежи в пределах разрешений ключа. ### Что нужно заранее Пользователь интернет-банка с правом на интеграции. ### Шаги ### Откройте «Интеграции и API» Интернет-банк Точки → **«Сервисы» → «Все сервисы» → «Интеграции и API»**. ### Создайте JWT-ключ Нажмите **«Создать JWT-ключ»**, укажите название и срок доступа, затем «Продолжить». ### Выдайте разрешения и подтвердите по смс По умолчанию отмечены все разрешения. Для нескольких компаний права задаются отдельно. ### Скопируйте ключ и client_id Ключ появится в разделе **«JWT-ключи»**. Вставьте его в поле **«JWT-токен»**, а client_id рядом с ним в **«ID клиента»**: он нужен для вебхуков. ### Какие права выдать Разрешения на счета и выписки обязательны: без них запросы вернут «Forbidden by consent». ### Ограничения - Обновления у JWT-ключа нет: когда срок закончится, ключ перевыпускается вручную и вставляется заново. - При перевыпуске ключа меняется client_id: обновите и поле «ID клиента». ### Как отозвать доступ Удалите ключ в разделе «JWT-ключи»: доступ закрывается сразу. У нас нажмите **«Отключить»**. ### Неполадки - **«Forbidden by consent»**: у ключа нет разрешения на этот счёт или выписку. Выпустите ключ с нужными разрешениями. - **Статус «Ключи не приняты»**: срок ключа закончился или его удалили. Выпустите новый и нажмите **«Ввести ключи заново»**. ## Модульбанк Счета, баланс, история операций и платёжные поручения. Подробнее на [странице интеграции](/integrations/modulbank). ### Что умеет агент Читает компании, счета и историю операций. ### Что нужно заранее Учётная запись, под которой видны нужные компании и счета: токен видит только их. ### Шаги ### Откройте экран генерации токена Меню **«+» → «Интеграция с банком»**, либо **«Настройки» → «Услуги» → «API Банка» → «Генерация токена авторизации»**. ### Отметьте разрешения Отметьте **account-info** (компании и счета) и **operation-history** (история операций). ### Вставьте токен Скопируйте токен в поле **«API-токен»**. ### Какие права выдать account-info и operation-history. Токен равен доступу в кабинет, храните его как пароль. ### Ограничения Токен действует ограниченный срок и по его окончании аннулируется банком автоматически. ### Как отозвать доступ Нажмите **«Отключить»** у нас. В банке токен можно отозвать раньше срока. ### Неполадки - **Не видна компания**: токен выпущен под другой учётной записью. Выпустите его под той, где есть эта компания. ## Альфа-Банк Бизнес Счета, выписки, операции и платежи через Alfa API. Подробнее на [странице интеграции](/integrations/alfabank). ### Что умеет агент Читает счета, выписки и операции. ### Что нужно заранее Расчётный счёт с РКО и подключённый Альфа-Бизнес Онлайн. ### Шаги ### Запросите доступ к Alfa API Напишите на alfa_api@alfabank.ru с реквизитами компании. Договор придёт на подпись в Альфа-Бизнес Онлайн, после подписи банк выдаёт Client ID. ### Сформируйте запрос на сертификат Создайте CSR командой openssl req с данными компании и ИНН. Банк вернёт сертификат в PEM, приватный ключ остаётся только у вас. ### Пройдите «Песочницу» Проверьте методы в «Песочнице» и напишите банку письмо с темой «Завершено тестирование»: банк откроет рабочий доступ. ### Заполните форму В карточке **«Альфа-Банк Бизнес»** заполните **«API-ключ»**, **«Клиентский сертификат»** и **«Приватный ключ сертификата»**. ### Как отозвать доступ Нажмите **«Отключить»** у нас. Приватный ключ сертификата хранится только у вас: удалите его копии, если доступ больше не нужен. ### Неполадки - **Подключение не проходит после выдачи ключа**: тестирование в «Песочнице» не завершено, и рабочий доступ ещё не открыт. ## ЮKassa Приём платежей: платежи, возвраты, чеки, счета, автоплатежи. Подробнее на [странице интеграции](/integrations/yookassa). ### Что умеет агент Смотрит платежи и их статусы, оформляет возвраты и счета в пределах ключа магазина. ### Что нужно заранее Роль владельца магазина или «Разработчик» в кабинете ЮKassa: другим ключи не показываются. ### Шаги ### Скопируйте shopId Выберите магазин вверху кабинета и откройте **«Настройки → Магазин»**: идентификатор подписан как shopId. Вставьте его в **«ID магазина»**. ### Выпустите секретный ключ **«Интеграция → Ключи API»** → **«Выпустить ключ»**, подтвердите SMS-паролем. ### Скопируйте ключ сразу Ключ показывается один раз. Вставьте его в **«Секретный ключ»**. ### Ограничения У каждого магазина, включая тестовый, свой shopId: ключ и shopId должны быть от одного магазина. ### Как отозвать доступ Перевыпустите или удалите ключ в «Интеграция → Ключи API». У нас нажмите **«Отключить»**. ### Неполадки - **Статус «Ключи не приняты»**: ключ перевыпущен. Вставьте новый через **«Ввести ключи заново»**. ## Robokassa Приём платежей: ссылки и счета, статусы, холд, повторные списания, возвраты, чеки. Подробнее на [странице интеграции](/integrations/robokassa). ### Что умеет агент Создаёт ссылки на оплату и счета, проверяет статусы, делает возвраты, если подключён API возвратов. ### Шаги ### Откройте технические настройки магазина На partner.robokassa.ru: **«Мои магазины» → «Технические настройки»**. Идентификатор магазина (MerchantLogin) вставьте в **«Логин мерчанта»**. Это логин магазина, а не почта входа. ### Проверьте алгоритм хеша Там же должен стоять метод MD5. Если выбран другой, верните MD5. ### Скопируйте рабочие пароли Из рабочего блока перенесите **«Пароль #1»** и **«Пароль #2»**. **«Пароль #3»** нужен только для возвратов и появляется после подключения API возвратов. ### Как отозвать доступ Смените пароли магазина в «Технических настройках». У нас нажмите **«Отключить»**. ### Неполадки - **Подпись не сходится**: в магазине выбран не MD5 или вставлены тестовые пароли вместо рабочих. ## Adesk Управленческий учёт: операции, ДДС, ОПиУ, проекты, бюджеты. Подробнее на [странице интеграции](/integrations/adesk). ### Что умеет агент Читает операции, отчёты ДДС и ОПиУ, проекты, обязательства и бюджеты. ### Шаги ### Войдите под владельцем аккаунта Ключ API принадлежит аккаунту целиком и видит все юрлица, счета и проекты профиля. ### Скопируйте ключ из профиля **«Настройки» → «Профиль»**, блок с ключом доступа к API. Вставьте его в **«API-токен»** без пробелов по краям. ### Ограничения Без пробного периода или оплаченной подписки Adesk закрывает все методы API и отвечает «Payment required». ### Как отозвать доступ Нажмите **«Отключить»** у нас. Ключ в Adesk относится ко всему аккаунту. ### Неполадки - **«Payment required»**: продлите подписку Adesk. - **Вход по API заблокирован**: после нескольких неверных ключей подряд Adesk временно блокирует вход. Скопируйте ключ заново из профиля, не подбирайте его.