В Т-Банк Бизнес несколько счетов, а агент видит не все. Почему?

Доступ в Т-Бизнесе выдаётся по каждому счёту отдельно. На главной выберите счёт → «Настройки» → «Доступ к счету», отметьте пользователя и сохраните. Неотмеченный счёт агенту недоступен.

Почему СберБизнес просит код авторизации и куда его взять?

Sber API выдаёт доступ по одноразовому коду. Заполните остальные поля формы, пройдите авторизацию СберБизнеса, скопируйте значение code из адреса, на который вас вернул банк, вставьте его в поле «Код авторизации» и сразу нажмите «Подключить»: код быстро истекает.

Может ли агент сам отправить платёж из банка?

Платёжное поручение агент готовит, если права ключа это позволяют, а подпись и отправку делаете вы в интернет-банке. Каждое изменение проходит проверку действий, рискованное приходит в чат карточкой.

Как закрыть агенту доступ к банку?

Нажмите «Отключить» в карточке банка у нас и удалите ключ или токен в самом банке: у Точки это раздел «JWT-ключи», у Т-Бизнеса отметка пользователя в «Доступе к счету». «Отключить» у нас доступ в банке не закрывает.

Банки и приём платежей

Банки и кассы подключаются в разделе «Интеграции». Общие правила (виды подключения, статусы карточки, «Только чтение», отключение) описаны на странице «Подключение сервисов». Как агент спрашивает перед изменениями, рассказано в «Как агент меняет данные».

Агент работает с правами того пользователя или ключа, который вы подключили. Ключ или токен банка открывает доступ к счетам: храните его как пароль. Подпись и отправка платежей остаются за вами в интернет-банке.

Т-Банк Бизнес

Счета, выписки, платежи, зарплата и карты. Подробнее на странице интеграции.

Что умеет агент

Читает счета, балансы и выписки, разбирает операции по контрагентам и статьям. Платёжное поручение готовит, если права пользователя это позволяют, подпись и отправка остаются в банке.

Что нужно заранее

Номер телефона, к которому в Т-Бизнесе привязан доступ к компании. Токены копировать не нужно.

Шаги

Нажмите «Подключить через Т-Банк»

В разделе «Интеграции» откройте карточку «Т-Банк Бизнес» и нажмите «Подключить через Т-Банк».

Войдите в Т-Бизнес

Войдите на business.tbank.ru по номеру, к которому привязан доступ к компании. Если на номер оформлено несколько компаний, сверьте ИНН нужной.

Подтвердите доступ

После подтверждения подключение подписано названием компании.

Какие права выдать

Уровень доступа. В «Настройки профиля и доступы» → «Компания» → «Пользователи» три уровня: «Директор», «Подписант», «Менеджер». Менять уровни может только «Директор», поэтому подключать лучше под ним.
Счета. Доступ настраивается по каждому счёту отдельно: на главной выберите счёт → «Настройки» → «Доступ к счету», отметьте пользователя → «Сохранить». Неотмеченный счёт агент не увидит.

Ограничения

Операции по счетам доступны начиная с июня 2023 года, более ранние выписки выгружайте из интернет-банка вручную.
Несколько компаний на одном номере подключаются отдельно. В запросе называйте нужную: «по счетам ООО …, а не ИП».

Как отозвать доступ

Нажмите «Отключить» в карточке у нас. В Т-Бизнесе снимите отметку пользователя в «Доступе к счету» или поменяйте его уровень.

Неполадки

Агент видит не все счета: счёт не отмечен в «Доступе к счету».
Статус «Требуется переподключение»: нажмите «Переподключить» и войдите заново.

СберБизнес

Счета, выписки, платежи, контрагенты, корпоративные карты и зарплата через Sber API. Подробнее на странице интеграции.

Что умеет агент

Читает счета и выписки, справочник контрагентов, карты и зарплатные данные в пределах прав, которые вы выбрали при подключении 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 заново.

Точка Банк

Счета, выписки, платежи и СБП. Подробнее на странице интеграции.

Что умеет агент

Читает счета и выписки, готовит платежи в пределах разрешений ключа.

Что нужно заранее

Пользователь интернет-банка с правом на интеграции.

Шаги

Откройте «Интеграции и API»

Интернет-банк Точки → «Сервисы» → «Все сервисы» → «Интеграции и API».

Создайте JWT-ключ

Нажмите «Создать JWT-ключ», укажите название и срок доступа, затем «Продолжить».

Выдайте разрешения и подтвердите по смс

По умолчанию отмечены все разрешения. Для нескольких компаний права задаются отдельно.

Скопируйте ключ и client_id

Ключ появится в разделе «JWT-ключи». Вставьте его в поле «JWT-токен», а client_id рядом с ним в «ID клиента»: он нужен для вебхуков.

Какие права выдать

Разрешения на счета и выписки обязательны: без них запросы вернут «Forbidden by consent».

Ограничения

Обновления у JWT-ключа нет: когда срок закончится, ключ перевыпускается вручную и вставляется заново.
При перевыпуске ключа меняется client_id: обновите и поле «ID клиента».

Как отозвать доступ

Удалите ключ в разделе «JWT-ключи»: доступ закрывается сразу. У нас нажмите «Отключить».

Неполадки

«Forbidden by consent»: у ключа нет разрешения на этот счёт или выписку. Выпустите ключ с нужными разрешениями.
Статус «Ключи не приняты»: срок ключа закончился или его удалили. Выпустите новый и нажмите «Ввести ключи заново».

Модульбанк

Счета, баланс, история операций и платёжные поручения. Подробнее на странице интеграции.

Что умеет агент

Читает компании, счета и историю операций.

Что нужно заранее

Учётная запись, под которой видны нужные компании и счета: токен видит только их.

Шаги

Откройте экран генерации токена

Меню «+» → «Интеграция с банком», либо «Настройки» → «Услуги» → «API Банка» → «Генерация токена авторизации».

Отметьте разрешения

Отметьте account-info (компании и счета) и operation-history (история операций).

Вставьте токен

Скопируйте токен в поле «API-токен».

Какие права выдать

account-info и operation-history. Токен равен доступу в кабинет, храните его как пароль.

Ограничения

Токен действует ограниченный срок и по его окончании аннулируется банком автоматически.

Как отозвать доступ

Нажмите «Отключить» у нас. В банке токен можно отозвать раньше срока.

Неполадки

Не видна компания: токен выпущен под другой учётной записью. Выпустите его под той, где есть эта компания.

Альфа-Банк Бизнес

Счета, выписки, операции и платежи через Alfa API. Подробнее на странице интеграции.

Что умеет агент

Читает счета, выписки и операции.

Что нужно заранее

Расчётный счёт с РКО и подключённый Альфа-Бизнес Онлайн.

Шаги

Запросите доступ к Alfa API

Напишите на alfa_api@alfabank.ru с реквизитами компании. Договор придёт на подпись в Альфа-Бизнес Онлайн, после подписи банк выдаёт Client ID.

Сформируйте запрос на сертификат

Создайте CSR командой openssl req с данными компании и ИНН. Банк вернёт сертификат в PEM, приватный ключ остаётся только у вас.

Пройдите «Песочницу»

Проверьте методы в «Песочнице» и напишите банку письмо с темой «Завершено тестирование»: банк откроет рабочий доступ.

Заполните форму

В карточке «Альфа-Банк Бизнес» заполните «API-ключ», «Клиентский сертификат» и «Приватный ключ сертификата».

Как отозвать доступ

Нажмите «Отключить» у нас. Приватный ключ сертификата хранится только у вас: удалите его копии, если доступ больше не нужен.

Неполадки

Подключение не проходит после выдачи ключа: тестирование в «Песочнице» не завершено, и рабочий доступ ещё не открыт.

ЮKassa

Приём платежей: платежи, возвраты, чеки, счета, автоплатежи. Подробнее на странице интеграции.

Что умеет агент

Смотрит платежи и их статусы, оформляет возвраты и счета в пределах ключа магазина.

Что нужно заранее

Роль владельца магазина или «Разработчик» в кабинете ЮKassa: другим ключи не показываются.

Шаги

Скопируйте shopId

Выберите магазин вверху кабинета и откройте «Настройки → Магазин»: идентификатор подписан как shopId. Вставьте его в «ID магазина».

Выпустите секретный ключ

«Интеграция → Ключи API» → «Выпустить ключ», подтвердите SMS-паролем.

Скопируйте ключ сразу

Ключ показывается один раз. Вставьте его в «Секретный ключ».

Ограничения

У каждого магазина, включая тестовый, свой shopId: ключ и shopId должны быть от одного магазина.

Как отозвать доступ

Перевыпустите или удалите ключ в «Интеграция → Ключи API». У нас нажмите «Отключить».

Неполадки

Статус «Ключи не приняты»: ключ перевыпущен. Вставьте новый через «Ввести ключи заново».

Robokassa

Приём платежей: ссылки и счета, статусы, холд, повторные списания, возвраты, чеки. Подробнее на странице интеграции.

Что умеет агент

Создаёт ссылки на оплату и счета, проверяет статусы, делает возвраты, если подключён API возвратов.

Шаги

Откройте технические настройки магазина

На partner.robokassa.ru: «Мои магазины» → «Технические настройки». Идентификатор магазина (MerchantLogin) вставьте в «Логин мерчанта». Это логин магазина, а не почта входа.

Проверьте алгоритм хеша

Там же должен стоять метод MD5. Если выбран другой, верните MD5.

Скопируйте рабочие пароли

Из рабочего блока перенесите «Пароль #1» и «Пароль #2». «Пароль #3» нужен только для возвратов и появляется после подключения API возвратов.

Как отозвать доступ

Смените пароли магазина в «Технических настройках». У нас нажмите «Отключить».

Неполадки

Подпись не сходится: в магазине выбран не MD5 или вставлены тестовые пароли вместо рабочих.

Adesk

Управленческий учёт: операции, ДДС, ОПиУ, проекты, бюджеты. Подробнее на странице интеграции.

Что умеет агент

Читает операции, отчёты ДДС и ОПиУ, проекты, обязательства и бюджеты.

Шаги

Войдите под владельцем аккаунта

Ключ API принадлежит аккаунту целиком и видит все юрлица, счета и проекты профиля.

Скопируйте ключ из профиля

«Настройки» → «Профиль», блок с ключом доступа к API. Вставьте его в «API-токен» без пробелов по краям.

Ограничения

Без пробного периода или оплаченной подписки Adesk закрывает все методы API и отвечает «Payment required».

Как отозвать доступ

Нажмите «Отключить» у нас. Ключ в Adesk относится ко всему аккаунту.

Неполадки

«Payment required»: продлите подписку Adesk.
Вход по API заблокирован: после нескольких неверных ключей подряд Adesk временно блокирует вход. Скопируйте ключ заново из профиля, не подбирайте его.